IDirectInputEffectDriver::D eviceID-Methode (dinputd.h)

Artikel
08/23/2023

Die IDirectInputEffectDriver::D eviceID-Methode sendet dem Treiber die Identität des Geräts.

Syntax

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

Parameter

unnamedParam1

Gibt die Versionsnummer von DirectInput an, die den Effekttreiber geladen hat. Bei DirectInput 5.0 ist der Wert dieses Parameters beispielsweise 0x00000500.

unnamedParam2

Gibt die Joystick-ID-Nummer an. Das Microsoft Windows-Joysticksubsystem ordnet externe IDs zu.

unnamedParam3

Gibt die Verfügbarkeit des Geräts an. Dieser Wert ist ungleich null, wenn der Zugriff auf das Gerät beginnt, und null, wenn der Zugriff auf das Gerät endet.

unnamedParam4

Gibt die ID des internen Joysticks an. Der Gerätetreiber verwaltet interne IDs.

unnamedParam5

Verweist auf eine DIHIDFFINITINFO-Struktur , die Initialisierungsinformationen für den Kraftrückmeldungstreiber enthält. Der Treiber verwendet diese Informationen, um zwischen mehreren Geräten zu unterscheiden und DirectInput nach anderen Geräteattributen abzufragen.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK zurück. Gibt andernfalls einen Fehlercode zurück.

Hinweise

Beispiel für die IDirectInputEffectDriver::D eviceID-Methode : Wenn ein Gerätetreiber dwExternalID = 2 und dwInternalId = 1 übergeben wird, entspricht Einheit 1 auf dem Gerät dem Joystick, dessen ID 2 ist.

Anforderungen


Zielplattform	Desktop
Kopfzeile	dinputd.h (include Dinputd.h)

Freigeben über