WdfDriverOpenPersistentStateRegistryKey 函数 (wdfdriver.h)

  • 项目

驱动程序应使用 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

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

返回值

请参阅 WdfDriverOpenParametersRegistryKey。

注解

键 Parameters 适用于 INF 文件中提供的 不可变 设置。 若要访问这些设置，请使用 WdfDriverOpenParametersRegistryKey。 从此 API 返回的密钥适用于在运行时写入的设置。

要求

要求 值
最低受支持的客户端 Windows 10 版本 1803
最低 KMDF 版本 1.25
最低 UMDF 版本 2.25
标头 wdfdriver.h
IRQL PASSIVE_LEVEL

另请参阅

WdfDriverOpenParametersRegistryKey

IoOpenDriverRegistryKey

DRIVER_REGKEY_TYPE