WdfUsbTargetDeviceGetDeviceDescriptor 関数 (wdfusb.h)

[KMDF と UMDF に適用]

WdfUsbTargetDeviceGetDeviceDescriptor メソッドは、指定されたフレームワーク USB デバイス オブジェクトに関連付けられている USB デバイスの USB デバイス記述子を取得します。

構文

void WdfUsbTargetDeviceGetDeviceDescriptor(
  [in]  WDFUSBDEVICE           UsbDevice,
  [out] PUSB_DEVICE_DESCRIPTOR UsbDeviceDescriptor
);

パラメーター

[in] UsbDevice

WdfUsbTargetDeviceCreateWithParameters の以前の呼び出しから取得された USB デバイス オブジェクトへのハンドル。

[out] UsbDeviceDescriptor

USB デバイス記述子を受け取る呼び出し元によって割り当てられた USB_DEVICE_DESCRIPTOR 構造体へのポインター。

戻り値

なし

解説

ドライバー指定のオブジェクト ハンドルが無効な場合、バグ チェックが発生します。

WdfUsbTargetDeviceGetDeviceDescriptor メソッドと USB I/O ターゲットの詳細については、「USB I/O ターゲット」を参照してください。

例

次のコード例では、デバイスの USB デバイス記述子を取得します。 この例では、ドライバー定義のコンテキスト空間に記述子を格納します。

PMY_DEVICE_CONTEXT  myDeviceContext;

myDeviceContext = GetDeviceContext(device);

WdfUsbTargetDeviceGetDeviceDescriptor(
                                      myDeviceContext->UsbTargetDevice,
                                      &myDeviceContext->UsbDeviceDescr
                                      );

要件

要件	値
対象プラットフォーム	ユニバーサル
最小 KMDF バージョン	1.0
最小 UMDF バージョン	2.0
Header	wdfusb.h (Wdfusb.h を含む)
Library	Wdf01000.sys (KMDF);WUDFx02000.dll (UMDF)
IRQL	PASSIVE_LEVEL
DDI コンプライアンス規則	DriverCreate(kmdf)、 KmdfIrql(kmdf)、 KmdfIrql2(kmdf)、KmdfIrqlExplicit(kmdf)、 UsbKmdfIrql(kmdf)、 UsbKmdfIrql2(kmdf)、UsbKmdfIrqlExplicit(kmdf)

こちらもご覧ください

USB_DEVICE_DESCRIPTOR

WdfUsbTargetDeviceCreateWithParameters