Función WdfDriverOpenParametersRegistryKey (wdfdriver.h)

[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:

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.

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

Consulte también

ACCESS_MASK

WDF_OBJECT_ATTRIBUTES

WdfDriverCreate

WdfDriverGetRegistryPath

WdfGetDriver

WdfRegistryClose