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) |