WdfRegistryWdmGetHandle 函数 (wdfregistry.h)

[适用于 KMDF 和 UMDF]

WdfRegistryWdmGetHandle 方法将 Windows 驱动程序模型 (WDM) 句柄返回到指定的框架注册表项对象表示的注册表项。

语法

HANDLE WdfRegistryWdmGetHandle(
  [in] WDFKEY Key
);

[in] Key

表示打开的注册表项的注册表项对象的句柄。

WdfRegistryWdmGetHandle 将 WDM 句柄返回到注册表项。

如果驱动程序提供无效的对象句柄，则会发生 bug 检查。

KMDF 驱动程序可以将返回的 WDM 句柄传递给接受 WDM 句柄作为输入的 ZwXxx 例程。

UMDF 驱动程序可以将返回的句柄传递给需要 HKEY 的 API，例如 RegEnumKeyEx。

在删除注册表项对象之前， WdfRegistryWdmGetHandle 方法返回的句柄是有效的。如果驱动程序为注册表项对象提供 EvtCleanupCallback 函数，则指针在回调函数返回之前有效。

有关注册表项对象的详细信息，请参阅在 Framework-Based 驱动程序中使用注册表。

下面的代码示例获取指定框架注册表项对象表示的注册表项的 WDM 句柄。

HANDLE hKey;

hKey = WdfRegistryWdmGetHandle(Key);