WdfRegistryWdmGetHandle 関数 (wdfregistry.h)

[KMDF と UMDF に適用]

WdfRegistryWdmGetHandle メソッドは、指定されたフレームワーク レジストリ キー オブジェクトが表すレジストリ キーに Windows ドライバー モデル (WDM) ハンドルを返します。

構文

HANDLE WdfRegistryWdmGetHandle(
  [in] WDFKEY Key
);

パラメーター

[in] Key

開かれたレジストリ キーを表すレジストリ キー オブジェクトへのハンドル。

戻り値

WdfRegistryWdmGetHandle は、レジストリ キーに WDM ハンドルを返します。

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

注釈

KMDF ドライバーは、WDM ハンドルを入力として受け入れる ZwXxx ルーチン に返された WDM ハンドルを渡すことができます。

UMDF ドライバーは、返されたハンドルを、 RegEnumKeyEx などの HKEY を必要とする API に渡すことができます。

WdfRegistryWdmGetHandle メソッドが返すハンドルは、レジストリ キー オブジェクトが削除されるまで有効です。 ドライバーがレジストリ キー オブジェクトの EvtCleanupCallback 関数を提供する場合、ポインターはコールバック関数が返されるまで有効です。

レジストリ キー オブジェクトの詳細については、「 Framework-Based ドライバーでのレジストリの使用」を参照してください。

例

次のコード例では、指定したフレームワーク レジストリ キー オブジェクトが表すレジストリ キーへの WDM ハンドルを取得します。

HANDLE hKey;

hKey = WdfRegistryWdmGetHandle(Key);

要件