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)

こちらもご覧ください

WdfDeviceMiniportCreate