fonction WinUsb_QueryDeviceInformation (winusb.h)

La fonction WinUsb_QueryDeviceInformation obtient des informations sur l’appareil physique associé à un handle d’interface WinUSB.

Syntaxe

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

Paramètres

[in] InterfaceHandle

Poignée opaque à la première interface de l’appareil, qui est retournée par WinUsb_Initialize.

[in] InformationType

Valeur qui spécifie la valeur d’informations d’interface à récupérer.

En entrée, InformationType doit avoir la valeur suivante : DEVICE_SPEED (0x01).

[in, out] BufferLength

Nombre maximal d'octets à lire. Ce nombre doit être inférieur ou égal à la taille, en octets, de La mémoire tampon. Sur la sortie, BufferLength est défini sur le nombre réel d’octets qui ont été copiés dans Buffer.

[out] Buffer

Mémoire tampon allouée à l’appelant qui reçoit la valeur demandée.

Si InformationType est DEVICE_SPEED, une fois le retour réussi, Buffer indique la vitesse de fonctionnement de l’appareil. 0x03 indique une vitesse élevée ou supérieure; 0x01 indique une vitesse maximale ou inférieure.

Valeur retournée

WinUsb_QueryDeviceInformation retourne TRUE si l’opération réussit. Sinon, cette routine retourne FALSE et l’appelant peut récupérer l’erreur journalisée en appelant GetLastError.

GetLastError peut retourner le code d’erreur suivant.

Code de retour	Description
ERROR_INVALID_HANDLE	L’appelant a passé la valeur NULL dans le paramètre InterfaceHandle .

Configuration requise

Plateforme cible	Universal
En-tête	winusb.h (inclure Winusb.h)
Bibliothèque	Winusb.lib
DLL	Winusb.dll

Voir aussi

WinUSB

Fonctions WinUSB

WinUsb_Initialize