WdfWdmDeviceGetWdfDeviceHandle 関数 (wdfdevice.h)
[KMDF にのみ適用]
WdfWdmDeviceGetWdfDeviceHandle メソッドは、指定された WDM デバイス オブジェクトに関連付けられているフレームワーク デバイス オブジェクトへのハンドルを返します。
構文
WDFDEVICE WdfWdmDeviceGetWdfDeviceHandle(
[in] PDEVICE_OBJECT DeviceObject
);
パラメーター
[in] DeviceObject
呼び出し元ドライバーが作成した WDM DEVICE_OBJECT 構造体へのポインター。
戻り値
指定した WDM デバイス オブジェクトが有効な場合、 WdfWdmDeviceGetWdfDeviceHandle は、関連付けられているフレームワーク デバイス オブジェクトへのハンドルを返します。 それ以外の場合、メソッドは NULL を返します。
注釈
ドライバーが DeviceObject パラメーターに指定する WDM DEVICE_OBJECT構造体は、呼び出し元のドライバーが作成したデバイス オブジェクトを表す必要があります。 たとえば、構造体は、 WdfDeviceMiniportCreate の以前の呼び出しでドライバーが指定した WDM デバイス オブジェクトを表すことはできません。
例
次のコード例では、呼び出し元のドライバーが作成した WDM デバイス オブジェクトに関連付けられているフレームワーク デバイス オブジェクトへのハンドルを取得します。
WDFDEVICE device;
device = WdfWdmDeviceGetWdfDeviceHandle(pWdmDeviceObject);
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| 最小 KMDF バージョン | 1.0 |
| Header | wdfdevice.h (Wdf.h を含む) |
| Library | Wdf01000.sys (「Framework ライブラリのバージョン管理」を参照)。 |
| IRQL | <=DISPATCH_LEVEL |
| DDI コンプライアンス規則 | DriverCreate(kmdf)、 KmdfIrql(kmdf)、 KmdfIrql2(kmdf)、KmdfIrqlExplicit(kmdf) |