WdfIoTargetWdmGetTargetDeviceObject 関数 (wdfiotarget.h)

[アーティクル]
02/27/2024

[KMDF にのみ適用]

WdfIoTargetWdmGetTargetDeviceObject メソッドは、指定されたローカルまたはリモートの I/O ターゲットに関連付けられている Windows ドライバーモデル (WDM) デバイスオブジェクトへのポインターを返します。

構文

PDEVICE_OBJECT WdfIoTargetWdmGetTargetDeviceObject(
  [in] WDFIOTARGET IoTarget
);

パラメーター

[in] IoTarget

WdfDeviceGetIoTarget または WdfIoTargetCreate または特殊化された I/O ターゲットが提供するメソッドの以前の呼び出しから取得されたローカルまたはリモートの I/O ターゲットオブジェクトへのハンドル。

戻り値

WdfIoTargetWdmGetTargetDeviceObject は、WDM DEVICE_OBJECT 構造体へのポインターを返します。

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

注釈

ほとんどのフレームワークベースのドライバーは、I/O ターゲットの WDM デバイスオブジェクトにアクセスする必要はありません。

WdfIoTargetWdmGetTargetDeviceObject メソッドが返すポインターは、ドライバーが WdfIoTargetClose または WdfIoTargetCloseForQueryRemove を呼び出すか、リモート I/O ターゲットオブジェクトが削除されるまで有効です。ドライバーがリモート I/O ターゲットオブジェクトの EvtCleanupCallback 関数を提供し、リモート I/O ターゲットを閉じる前にオブジェクトが削除された場合、 ポインターは EvtCleanupCallback 関数が返されるまで有効です。

ドライバーが削除された後に WDM デバイスオブジェクトにアクセスしようとすると、ドライバーによってシステムがクラッシュする可能性があります。トーストモンサンプルは、ドライバーが EvtIoTargetQueryRemove コールバック関数を提供して、I/O ターゲットが削除された場合に通知されるようにする方法を示しています。

WdfIoTargetWdmGetTargetDeviceObject の詳細については、「一般的な I/O ターゲットに関する情報の取得」を参照してください。

I/O ターゲットの詳細については、「I /O ターゲットの使用」を参照してください。

例

次のコード例では、I/O ターゲットの WDM DEVICE_OBJECT構造を調べて、ターゲットが直接 I/O 操作をサポートしていることを確認します。

if (!((WdfIoTargetWdmGetTargetDeviceObject(Adapter->IoTarget))->Flags
 & DO_DIRECT_IO)) {
    ASSERTMSG("Target device doesn't support direct I/O\n", FALSE);
    return STATUS_INVALID_DEVICE_REQUEST;
}

要件

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