fonction WinUsb_QueryDeviceInformation (winusb.h)

Article
08/27/2023

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.