IDirectInputEffectDriver::DeviceID method (dinputd.h)

Article
02/22/2024

The IDirectInputEffectDriver::DeviceID method sends the driver the identity of the device.

Syntax

HRESULT DeviceID(
  DWORD  unnamedParam1,
  DWORD  unnamedParam2,
  DWORD  unnamedParam3,
  DWORD  unnamedParam4,
  LPVOID unnamedParam5
);

Parameters

unnamedParam1

Specifies the version number of DirectInput that loaded the effect driver. For example, with DirectInput 5.0, the value of this parameter is 0x00000500.

unnamedParam2

Specifies the joystick ID number. The Microsoft Windows joystick subsystem allocates external IDs.

unnamedParam3

Specifies the availability of the device. This value is nonzero if access to the device is beginning, and zero if access to the device is ending.

unnamedParam4

Specifies the ID of the internal joystick. The device driver manages internal IDs.

unnamedParam5

Points to a DIHIDFFINITINFO structure that contains initialization information for the force feedback driver. The driver uses this information to distinguish between multiple devices and to query DirectInput for any other device attributes.

Return value

Returns S_OK if successful; otherwise, returns an error code.

Remarks

As an example of the IDirectInputEffectDriver::DeviceID method, if a device driver is passed dwExternalID = 2 and dwInternalId = 1, then unit 1 on the device corresponds to the joystick whose ID is 2.

Requirements

Requirement	Value
Target Platform	Desktop
Header	dinputd.h (include Dinputd.h)

Share via