WdfDriverOpenPersistentStateRegistryKey 函数（wdfdriver.h）

项目
2025-03-22

驱动程序应使用 WdfDriverOpenPersistentStateRegistryKey 将驱动程序范围的持久性信息写入注册表。

语法

NTSTATUS WdfDriverOpenPersistentStateRegistryKey(
  [in]           WDFDRIVER              Driver,
  [in]           ACCESS_MASK            DesiredAccess,
  [in, optional] PWDF_OBJECT_ATTRIBUTES KeyAttributes,
  [out]          WDFKEY                 *Key
);

参数

[in] Driver

驱动程序的框架驱动程序对象的句柄，驱动程序从先前调用 WdfDriverCreate 或 WdfGetDriver获取。

[in] DesiredAccess

ACCESS_MASK 类型化值，该值指定注册表项的访问掩码。 KMDF 驱动程序通常请求 KEY_READ、KEY_WRITE或 KEY_READ | KEY_WRITE。如果要编写 UMDF 驱动程序，请使用 KEY_READ 或 KEY_READ | KEY_SET_VALUE。最佳做法是仅请求驱动程序所需的访问类型。

[in, optional] KeyAttributes

指向调用方分配 WDF_OBJECT_ATTRIBUTES 结构的指针，该结构指定框架注册表项对象的对象属性。此参数是可选的，可以WDF_NO_OBJECT_ATTRIBUTES。

[out] Key

指向接收框架注册表项对象的句柄的位置的指针。