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 |