funzione WinUsb_QueryDeviceInformation (winusb.h)

Articolo
08/27/2023

La funzione WinUsb_QueryDeviceInformation ottiene informazioni sul dispositivo fisico associato a un handle di interfaccia WinUSB.

Sintassi

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

Parametri

[in] InterfaceHandle

Handle opaco per la prima interfaccia del dispositivo, restituita da WinUsb_Initialize.

[in] InformationType

Valore che specifica il valore delle informazioni di interfaccia da recuperare.

In input , InformationType deve avere il valore seguente: DEVICE_SPEED (0x01).

[in, out] BufferLength

Numero massimo di byte da leggere. Questo numero deve essere minore o uguale alla dimensione, espressa in byte, di Buffer. Nell'output BufferLength viene impostato sul numero effettivo di byte copiati nel buffer.

[out] Buffer

Buffer allocato dal chiamante che riceve il valore richiesto.

Se InformationType è DEVICE_SPEED, in caso di esito positivo, buffer indica la velocità operativa del dispositivo. 0x03 indica velocità elevata o superiore; 0x01 indica la velocità massima o inferiore.

Valore restituito

WinUsb_QueryDeviceInformation restituisceTRUE se l'operazione ha esito positivo. In caso contrario, questa routine restituisce FALSE e il chiamante può recuperare l'errore registrato chiamando GetLastError.

GetLastError può restituire il codice di errore seguente.