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);