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