Función WdfDriverOpenParametersRegistryKey (wdfdriver.h)

Artículo
08/08/2023

[Se aplica a KMDF y UMDF]

El método WdfDriverOpenParametersRegistryKey abre la clave del Registro Parameters del controlador y recupera un identificador de un objeto de clave del Registro del marco que representa la clave.

Sintaxis

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

Parámetros

[in] Driver

Identificador del objeto de controlador del marco de trabajo del controlador que obtuvo el controlador de una llamada anterior a WdfDriverCreate o WdfGetDriver.

[in] DesiredAccess

Valor con tipo ACCESS_MASK que especifica una máscara de acceso para la clave del Registro Parameters .

Normalmente, un controlador KMDF solicita KEY_READ, KEY_WRITE o KEY_READ | KEY_WRITE.

Si está escribiendo un controlador UMDF, use KEY_READ o KEY_READ | KEY_SET_VALUE.

Como procedimiento recomendado, solicite solo los tipos de acceso que necesita el controlador.

[in, optional] KeyAttributes

Puntero a una estructura de WDF_OBJECT_ATTRIBUTES asignada por el autor de la llamada que especifica los atributos de objeto para el objeto de clave del Registro del marco. Este parámetro es opcional y se puede WDF_NO_OBJECT_ATTRIBUTES.

[out] Key

Puntero a una ubicación que recibe un identificador de un objeto de clave del Registro de marco.

Valor devuelto

WdfDriverOpenParametersRegistryKey devuelve STATUS_SUCCESS si la operación se realiza correctamente. Entre los valores devueltos adicionales se incluyen:

Código devuelto	Descripción
STATUS_ACCESS_DENIED	Un controlador UMDF especificó una de las marcas siguientes en el parámetro DesiredAccess : GENERIC_WRITE KEY_CREATE_SUBKEY WRITE_DAC Dado que los valores anteriores no son válidos para los controladores UMDF, las marcas universales como GENERIC_ALL y STANDARD_RIGHTS_ALL también hacen que WdfDriverOpenParametersRegistryKey produzca un error con este valor devuelto.

Código devuelto

Descripción

STATUS_ACCESS_DENIED

Un controlador UMDF especificó una de las marcas siguientes en el parámetro DesiredAccess :

GENERIC_WRITE
KEY_CREATE_SUBKEY
WRITE_DAC

Dado que los valores anteriores no son válidos para los controladores UMDF, las marcas universales como GENERIC_ALL y STANDARD_RIGHTS_ALL también hacen que WdfDriverOpenParametersRegistryKey produzca un error con este valor devuelto.

Para obtener más información sobre los valores devueltos, vea Errores de creación de objetos de marco.

Este método también podría devolver otros valores NTSTATUS.

Se produce una comprobación de errores del sistema si un controlador KMDF especifica un identificador no válido en driver.

Comentarios

La clave Parameters del controlador se encuentra en el árbol Servicios del Registro. Si la clave Parameters del controlador no existe, el método WdfDriverOpenParametersRegistryKey lo crea.

Cuando el controlador haya terminado de usar la clave del Registro Parameters , el controlador debe llamar a WdfRegistryClose.

Nota

UMDF no admite la creación de subclaves.

Para obtener más información sobre el registro, consulte Uso del Registro en Framework-Based Controladores.

Ejemplos

En el ejemplo de código siguiente se abre la clave del Registro Parameters de un controlador y se obtiene un identificador para un objeto de clave del Registro del marco que representa la clave.

WDFKEY hKey;

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

Requisitos

Requisito	Value
Plataforma de destino	Universal
Versión mínima de KMDF	1.0
Versión mínima de UMDF	2.0
Encabezado	wdfdriver.h (incluya Wdf.h)
Library	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	PASSIVE_LEVEL
Reglas de cumplimiento de DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)