WdfRegistryWdmGetHandle 函数 （wdfregistry.h）

[适用于 KMDF 和 UMDF]

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

语法

HANDLE WdfRegistryWdmGetHandle(
  [in] WDFKEY Key
);

参数

[in] Key

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

返回值

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

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

言论

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

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

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

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

例子

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

HANDLE hKey;

hKey = WdfRegistryWdmGetHandle(Key);

要求