IWDFUsbTargetDevice::RetrieveDeviceInformation メソッド (wudfusb.h)
[警告: UMDF 2 は UMDF の最新バージョンであり、UMDF 1 よりも優先されます。 すべての新しい UMDF ドライバーは、UMDF 2 を使用して記述する必要があります。 UMDF 1 には新機能が追加されておらず、Windows 10 の新しいバージョンでは UMDF 1 のサポートが制限されています。 ユニバーサル Windows ドライバーでは、UMDF 2 を使用する必要があります。 詳細については、「UMDFの概要」を参照してください。
RetrieveDeviceInformation メソッドは、指定した型のデバイス情報を取得します。
構文
HRESULT RetrieveDeviceInformation(
[in] ULONG InformationType,
[in, out] ULONG *BufferLength,
[out] PVOID Buffer
);
パラメーター
[in] InformationType
UMDF ドライバーがデバイスに関して要求する情報の種類。
[in, out] BufferLength
入力時に、RetrieveDeviceInformation が提供 するバッファーのサイズをバイト単位で格納する変数へのポインター Buffer。 出力時に、このパラメーターには、Bufferに必要な RetrieveDeviceInformation サイズが含まれます。
[out] Buffer
デバイス情報を含むバッファーを受け取るポインター。
戻り値
RetrieveDeviceInformation は、次のいずれかの値を返します。
リターン コード | 形容 |
---|---|
|
RetrieveDeviceInformation デバイス情報を正常に取得しました。 |
|
RetrieveDeviceInformation 割り当てエラーが発生しました。 |
|
この値は、WinUsb API から返されたエラー コードに対応します。 |
備考
UMDF ドライバーが InformationType パラメーターに渡すことができる有効な情報の種類については、WinUsb_QueryDeviceInformation 関数を参照してください。
InformationType がDEVICE_SPEED (0x01) の場合、正常に戻ると、Buffer はデバイスの動作速度を示します。 0x03は高速以上を示します。0x01は全速度以下を示します。
RetrieveDeviceInformation メソッドは UMDF 要求を生成し、I/O ターゲットに同期的に要求を送信します。
例
RetrieveDeviceInformation メソッドを使用する方法のコード例については、「IWDFUsbTargetPipe::SetPipePolicy を参照してください。
必要条件
要件 | 価値 |
---|---|
サポート終了 | UMDF 2.0 以降では使用できません。 |
ターゲット プラットフォーム の | デスクトップ |
UMDF の最小バージョン を する | 1.5 |
ヘッダー | wudfusb.h (Wudfusb.h を含む) |
DLL | WUDFx.dll |
関連項目
IWDFUsbTargetDevice の