WdfDeviceWdmGetAttachedDevice 関数 (wdfdevice.h)
[KMDF にのみ適用]
WdfDeviceWdmGetAttachedDevice メソッドは、デバイス スタック内の次の下位 WDM デバイス オブジェクトを返します。
構文
PDEVICE_OBJECT WdfDeviceWdmGetAttachedDevice(
[in] WDFDEVICE Device
);
パラメーター
[in] Device
フレームワーク デバイス オブジェクトへのハンドル。
戻り値
WdfDeviceWdmGetAttachedDevice は 、WDM DEVICE_OBJECT 構造体へのポインターを返します。 指定したオブジェクト ハンドルが物理デバイス オブジェクト (PDO) を表す場合、メソッドは NULL を返します。
ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。
注釈
WdfDeviceWdmGetAttachedDevice メソッドが返すポインターは、フレームワーク デバイス オブジェクトが削除されるまで有効です。 ドライバーがフレームワーク デバイス オブジェクトの EvtCleanupCallback 関数を提供する場合、ポインターはコールバック関数が返されるまで有効です。
例
次のコード例では、デバイスの PDO、FDO、および次の下位デバイスを表す WDM デバイス オブジェクトへのポインターを含むトレース メッセージを作成します。
TraceEvents(
TRACE_LEVEL_INFORMATION,
DBG_PNP,
"PDO(0x%p) FDO(0x%p), Lower(0x%p)\n",
WdfDeviceWdmGetPhysicalDevice(device),
WdfDeviceWdmGetDeviceObject(device),
WdfDeviceWdmGetAttachedDevice(device)
);
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| 最小 KMDF バージョン | 1.0 |
| Header | wdfdevice.h (Wdf.h を含む) |
| Library | Wdf01000.sys (「Framework ライブラリのバージョン管理」を参照)。 |
| IRQL | <= DISPATCH_LEVEL |
| DDI コンプライアンス規則 | DriverCreate(kmdf)、 KmdfIrql(kmdf)、 KmdfIrql2(kmdf)、KmdfIrqlExplicit(kmdf) |