WinUsb_QueryDeviceInformation-Funktion (winusb.h)

Artikel
08/27/2023

Die WinUsb_QueryDeviceInformation-Funktion ruft Informationen über das physische Gerät ab, das einem WinUSB-Schnittstellenhandle zugeordnet ist.

Syntax

BOOL WinUsb_QueryDeviceInformation(
  [in]      WINUSB_INTERFACE_HANDLE InterfaceHandle,
  [in]      ULONG                   InformationType,
  [in, out] PULONG                  BufferLength,
  [out]     PVOID                   Buffer
);

Parameter

[in] InterfaceHandle

Ein undurchsichtiges Handle für die erste Schnittstelle auf dem Gerät, das von WinUsb_Initialize zurückgegeben wird.

[in] InformationType

Ein -Wert, der angibt, welcher Schnittstelleninformationswert abgerufen werden soll.

Bei der Eingabe muss InformationType den folgenden Wert aufweisen: DEVICE_SPEED (0x01).

[in, out] BufferLength

Die maximale Anzahl der zu lesenden Bytes. Diese Zahl muss kleiner oder gleich der Größe von Buffer in Bytes sein. Bei der Ausgabe wird BufferLength auf die tatsächliche Anzahl von Bytes festgelegt, die in Buffer kopiert wurden.

[out] Buffer

Ein vom Aufrufer zugewiesener Puffer, der den angeforderten Wert empfängt.

Wenn InformationType DEVICE_SPEED ist, gibt Buffer bei erfolgreicher Rückgabe die Betriebsgeschwindigkeit des Geräts an. 0x03 gibt eine hohe Geschwindigkeit oder eine höhere Geschwindigkeit an; 0x01 gibt die Volle Geschwindigkeit oder niedriger an.

Rückgabewert

WinUsb_QueryDeviceInformation gibt TRUE zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Routine FALSE zurück, und der Aufrufer kann den protokollierten Fehler durch Aufrufen von GetLastError abrufen.

GetLastError kann den folgenden Fehlercode zurückgeben.