función WinUsb_QueryDeviceInformation (winusb.h)

Artículo
08/27/2023

La función WinUsb_QueryDeviceInformation obtiene información sobre el dispositivo físico asociado a un identificador de interfaz winUSB.

Sintaxis

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

Parámetros

[in] InterfaceHandle

Identificador opaco de la primera interfaz del dispositivo, que devuelve WinUsb_Initialize.

[in] InformationType

Valor que especifica qué valor de información de interfaz se va a recuperar.

En la entrada, InformationType debe tener el siguiente valor: DEVICE_SPEED (0x01).

[in, out] BufferLength

Número máximo de bytes que se pueden leer. Este número debe ser menor o igual que el tamaño, en bytes, del búfer. En la salida, BufferLength se establece en el número real de bytes que se copiaron en buffer.

[out] Buffer

Un búfer asignado por el autor de la llamada que recibe el valor solicitado.

Si InformationType es DEVICE_SPEED, si se devuelve correctamente, Buffer indica la velocidad de funcionamiento del dispositivo. 0x03 indica alta velocidad o superior; 0x01 indica velocidad completa o inferior.

Valor devuelto

WinUsb_QueryDeviceInformation devuelve TRUE si la operación se realiza correctamente. De lo contrario, esta rutina devuelve FALSE y el autor de la llamada puede recuperar el error registrado llamando a GetLastError.

GetLastError puede devolver el siguiente código de error.