WinUsb_QueryDeviceInformation 函数 (winusb.h)

  • 项目

WinUsb_QueryDeviceInformation 函数获取有关与 WinUSB 接口句柄关联的物理设备的信息。

语法

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

参数

[in] InterfaceHandle

设备上第一个接口的不透明句柄， WinUsb_Initialize返回。

[in] InformationType

一个 值，该值指定要检索的接口信息值。

输入时， InformationType 必须具有以下值：DEVICE_SPEED (0x01) 。

[in, out] BufferLength

最多读取的字节数。 此数字必须小于或等于 Buffer 的大小（以字节为单位）。 在输出时， BufferLength 设置为复制到 Buffer 的实际字节数。

[out] Buffer

一个调用方分配的缓冲区，用于接收请求的值。

如果 InformationType 是DEVICE_SPEED，则成功返回时， Buffer 指示设备的运行速度。 0x03表示高速或更高;0x01表示全速或更低。

返回值

如果操作成功，WinUsb_QueryDeviceInformation返回 TRUE。 否则，此例程返回 FALSE，调用方可以通过调用 GetLastError 检索记录的错误。

GetLastError 可以返回以下错误代码。

返回代码 说明
ERROR_INVALID_HANDLE
 调用方在 InterfaceHandle 参数中传递 NULL。

要求

   
目标平台 通用
标头 winusb.h (包括 Winusb.h)
Library Winusb.lib
DLL Winusb.dll

另请参阅

WinUSB

WinUSB 函数

WinUsb_Initialize