função WinUsb_QueryDeviceInformation (winusb.h)

Artigo
08/27/2023

A função WinUsb_QueryDeviceInformation obtém informações sobre o dispositivo físico associado a um identificador de interface WinUSB.

Sintaxe

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

Parâmetros

[in] InterfaceHandle

Um identificador opaco para a primeira interface no dispositivo, que é retornado por WinUsb_Initialize.

[in] InformationType

Um valor que especifica qual valor de informações de interface recuperar.

Na entrada, InformationType deve ter o seguinte valor: DEVICE_SPEED (0x01).

[in, out] BufferLength

O número máximo de bytes a serem lidos. Esse número deve ser menor ou igual ao tamanho, em bytes, de Buffer. Na saída, BufferLength é definido como o número real de bytes que foram copiados para o Buffer.

[out] Buffer

Um buffer alocado pelo chamador que recebe o valor solicitado.

Se InformationType for DEVICE_SPEED, no retorno bem-sucedido, Buffer indicará a velocidade de operação do dispositivo. 0x03 indica alta velocidade ou superior; 0x01 indica velocidade total ou inferior.

Valor retornado

WinUsb_QueryDeviceInformationretornará TRUE se a operação for bem-sucedida. Caso contrário, essa rotina retornará FALSE e o chamador poderá recuperar o erro registrado chamando GetLastError.

GetLastError pode retornar o código de erro a seguir.