WdfIoTargetGetDevice 関数 (wdfiotarget.h)
[KMDF と UMDF に適用]
WdfIoTargetGetDevice メソッドは、指定されたローカルまたはリモート I/O ターゲットの親であるフレームワーク デバイス オブジェクトへのハンドルを返します。
構文
WDFDEVICE WdfIoTargetGetDevice(
[in] WDFIOTARGET IoTarget
);
パラメーター
[in] IoTarget
I/O ターゲット オブジェクトへのハンドル。 このハンドルは 、WdfDeviceGetIoTarget、 WdfIoTargetCreate、または 特殊化された I/O ターゲット が提供するメソッド ( WdfUsbTargetDeviceGetIoTarget など) から取得されます。
戻り値
WdfIoTargetGetDevice は 、フレームワーク デバイス オブジェクトへのハンドルを返します。
ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。
注釈
WdfIoTargetGetDevice の詳細については、「一般的な I/O ターゲットに関する情報の取得」を参照してください。
I/O ターゲットの詳細については、「 I/O ターゲットの使用」を参照してください。
例
次のコード例は、 EvtIoTargetQueryRemove コールバック関数が WdfIoTargetGetDevice を呼び出す方法を示しています。
NTSTATUS
MyEvtIoTargetQueryRemove(
WDFIOTARGET IoTarget
)
{
WDFDEVICE device;
...
device = WdfIoTargetGetDevice(IoTarget);
...
}
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| 最小 KMDF バージョン | 1.0 |
| 最小 UMDF バージョン | 2.0 |
| Header | wdfiotarget.h (Wdf.h を含む) |
| Library | Wdf01000.sys (KMDF);WUDFx02000.dll (UMDF) |
| IRQL | <=DISPATCH_LEVEL |
| DDI コンプライアンス規則 | DriverCreate(kmdf)、 KmdfIrql(kmdf)、 KmdfIrql2(kmdf)、KmdfIrqlExplicit(kmdf) |