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)

こちらもご覧ください

WdfDeviceGetIoTarget

WdfIoTargetCreate

WdfUsbTargetDeviceGetIoTarget