共用方式為

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。

規格需求

   
目標平台 Universal
標頭 winusb.h (包含 Winusb.h)
程式庫 Winusb.lib
Dll Winusb.dll

另請參閱

WinUSB

WinUSB 函式

WinUsb_Initialize