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 を渡しました。

要件

   
対象プラットフォーム ユニバーサル
Header winusb.h (Winusb.h を含む)
Library Winusb.lib
[DLL] Winusb.dll

関連項目

WinUSB

WinUSB 関数

WinUsb_Initialize