Función WdfDriverOpenParametersRegistryKey (wdfdriver.h)

[Se aplica a KMDF y UMDF]

El método WdfDriverOpenParametersRegistryKey abre el Parameters del controlador clave del Registro y recupera un identificador de un objeto de clave del Registro de 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 de tipo ACCESS_MASKque especifica una máscara de acceso para la clave del Registro Parameters.

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

Si escribe 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 de retorno	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 Framework.

Este método también puede devolver otros valores de NTSTATUS.

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

Observaciones

La clave parámetros del controlador se encuentra en el árbol Services del Registro. Si la clave parámetros 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 Using the Registry in Framework-Based Drivers.

Ejemplos

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

WDFKEY hKey;

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

Requisitos

Requisito	Valor
de la plataforma de destino de	Universal
versión mínima de KMDF	1.0
versión mínima de UMDF	2.0
encabezado	wdfdriver.h (incluya Wdf.h)
Biblioteca	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
irQL	PASSIVE_LEVEL
reglas de cumplimiento de DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Consulte también

ACCESS_MASK

WDF_OBJECT_ATTRIBUTES

WdfDriverCrear

WdfDriverGetRegistryPath

WdfGetDriver

WdfRegistryClose