WdfUsbTargetDeviceWdmGetConfigurationHandle 関数 (wdfusb.h)

[KMDF にのみ適用]

WdfUsbTargetDeviceWdmGetConfigurationHandle メソッドは、指定された USB デバイスの現在の構成に関連付けられているUSBD_CONFIGURATION_HANDLE型指定されたハンドルを返します。

構文

USBD_CONFIGURATION_HANDLE WdfUsbTargetDeviceWdmGetConfigurationHandle(
  [in] WDFUSBDEVICE UsbDevice
);

パラメーター

[in] UsbDevice

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

戻り値

ドライバーがデバイスの構成を選択した場合、 WdfUsbTargetDeviceWdmGetConfigurationHandle はデバイスのUSBD_CONFIGURATION_HANDLE型のハンドルを返します。 それ以外の場合、メソッドは NULL を返します。

ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。

注釈

フレームワーク ベースのドライバーは、_URB_SELECT_INTERFACE構造を含む URB を 作成する場合にのみ、 USBD_CONFIGURATION_HANDLE 型ハンドルを取得する必要があります。

WdfUsbTargetDeviceSelectConfig を呼び出した後、ドライバーは WdfUsbTargetDeviceWdmGetConfigurationHandle を呼び出すことができます。 WdfUsbTargetDeviceWdmGetConfigurationHandle が返すUSBD_CONFIGURATION_HANDLE型指定されたハンドルは、ドライバーが WdfUsbTargetDeviceSelectConfig を再度呼び出すか、USB デバイス オブジェクトが削除されるまで有効です。 ドライバーが USB デバイス オブジェクトの EvtCleanupCallback 関数を提供し、ドライバーが WdfUsbTargetDeviceSelectConfig を再度呼び出す前にオブジェクトが削除された場合、ハンドルはオブジェクトの EvtCleanupCallback 関数が返されるまで有効です。

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

例

次のコード例では、指定した USB デバイスの現在の構成へのハンドルを取得します。

USBD_CONFIGURATION_HANDLE deviceConfigHdl;

deviceConfigHdl = WdfUsbTargetDeviceWdmGetConfigurationHandle(UsbDevice);

要件

要件	値
対象プラットフォーム	ユニバーサル
最小 KMDF バージョン	1.0
Header	wdfusb.h (Wdfusb.h を含む)
Library	Wdf01000.sys (「Framework ライブラリのバージョン管理」を参照)。
IRQL	<=DISPATCH_LEVEL
DDI コンプライアンス規則	DriverCreate(kmdf)、 KmdfIrql(kmdf)、 KmdfIrql2(kmdf)、KmdfIrqlExplicit(kmdf)、 UsbKmdfIrql(kmdf)、 UsbKmdfIrql2(kmdf)、UsbKmdfIrqlExplicit(kmdf)

こちらもご覧ください

Urb

WdfUsbTargetDeviceSelectConfig

_URB_SELECT_INTERFACE