DIEFFESCAPE

The DIEFFESCAPE structure is used by the IDirectInputDevice2::Escape and IDirectInputEffect::Escape methods to pass hardware-specific data directly to the device driver.

typedef struct {
    DWORD dwSize;
    DWORD dwCommand;
    LPVOID lpvInBuffer;
    DWORD cbInBuffer;
    LPVOID lpvOutBuffer;
    DWORD cbOutBuffer;
} DIEFFESCAPE, *LPDIEFFESCAPE;
 

Members

dwSize

Size of the structure in bytes. This member must be initialized before the structure is used.

dwCommand

Driver-specific command number. Consult the driver documentation for a list of valid commands.

lpvInBuffer

Buffer containing the data required to perform the operation.

cbInBuffer

The size, in bytes, of the lpvInBuffer buffer.

lpvOutBuffer

Buffer in which the operation's output data is returned.

cbOutBuffer

On entry, the size in bytes of the lpvOutBuffer buffer. On exit, the number of bytes actually produced by the command.

Remarks

Since each driver implements different escapes, it is the application's responsibility to ensure that it is talking to the correct driver by comparing the guidFFDriver member in the DIDEVICEINSTANCE structure against the value the application is expecting.

QuickInfo

  Windows NT: Use version 5.0 or later.
  Windows: Use Windows 95 or later. Available as a redistributable for Windows 95.
  Windows CE: Unsupported.
  Header: Declared in dinput.h.