wdfDriverOpenParametersRegistryKey 函数 (wdfdriver.h)

[适用于 KMDF 和 UMDF]

WdfDriverOpenParametersRegistryKey 方法打开驱动程序的参数注册表项,并检索表示密钥的框架注册表项对象的句柄。

语法

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

参数

[in] Driver

驱动程序的框架驱动程序对象的句柄,该驱动程序是从以前调用 WdfDriverCreateWdfGetDriver 获得的。

[in] DesiredAccess

一个ACCESS_MASK类型的值,该值指定参数注册表项的访问掩码。

KMDF 驱动程序通常请求 KEY_READKEY_WRITEKEY_READ |KEY_WRITE

如果要编写 UMDF 驱动程序,请使用 KEY_READKEY_READ |KEY_SET_VALUE

最佳做法是仅要求驱动程序所需的访问类型。

[in, optional] KeyAttributes

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

[out] Key

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

返回值

如果操作成功,WdfDriverOpenParametersRegistryKey 将返回STATUS_SUCCESS。 其他返回值包括:

返回代码 说明
STATUS_ACCESS_DENIED
UMDF 驱动程序在 DesiredAccess 参数中指定了以下标志之一:
  • GENERIC_WRITE
  • KEY_CREATE_SUBKEY
  • WRITE_DAC

由于上述值对于 UMDF 驱动程序无效,因此通用标志(如GENERIC_ALL和STANDARD_RIGHTS_ALL也会导致 WdfDriverOpenParametersRegistryKey 使用此返回值失败。

 

有关返回值的详细信息,请参阅 Framework 对象创建错误

此方法还可能返回其他 NTSTATUS 值

如果 KMDF 驱动程序在 驱动程序中指定无效句柄,则会发生系统 bug 检查。

注解

驱动程序 的参数键 位于 注册表的服务树 中。 如果 驱动程序的参数密钥 不存在, 则 WdfDriverOpenParametersRegistryKey 方法将创建它。

驱动程序使用 Parameters 注册表项完成后,驱动程序必须调用 WdfRegistryClose

备注

UMDF 不支持创建子项。

有关注册表的详细信息,请参阅 Framework-Based驱动程序中使用注册表

示例

下面的代码示例打开 驱动程序的参数注册表项 ,并获取表示密钥的框架注册表项对象的句柄。

WDFKEY hKey;

status = WdfDriverOpenParametersRegistryKey(
                                            Driver,
                                            STANDARD_RIGHTS_ALL,
                                            WDF_NO_OBJECT_ATTRIBUTES,
                                            &hKey
                                            );

要求

   
目标平台 通用
最低 KMDF 版本 1.0
最低 UMDF 版本 2.0
Header wdfdriver.h (包括 Wdf.h)
Library Wdf01000.sys (KMDF) ;WUDFx02000.dll (UMDF)
IRQL PASSIVE_LEVEL
DDI 符合性规则 DriverCreate (kmdf) KmdfIrql (kmdf) KmdfIrql2 (kmdf) 、KmdfIrqlExplicit (kmdf)

另请参阅

ACCESS_MASK

WDF_OBJECT_ATTRIBUTES

WdfDriverCreate

WdfDriverGetRegistryPath

WdfGetDriver

WdfRegistryClose