Función WdfDriverOpenPersistentStateRegistryKey (wdfdriver.h)

Los controladores deben usar WdfDriverOpenPersistentStateRegistryKey para escribir información persistente de todo el controlador en el registro.

Sintaxis

NTSTATUS WdfDriverOpenPersistentStateRegistryKey(
  [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. 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

Consulte WdfDriverOpenParametersRegistryKey.

Comentarios

La Parameters clave es para la configuración inmutable proporcionada en el archivo INF. Para acceder a esa configuración, use WdfDriverOpenParametersRegistryKey. La clave devuelta de esta API es para la configuración escrita en tiempo de ejecución.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 10, versión 1803
Versión mínima de KMDF	1,25
Versión mínima de UMDF	2.25
Encabezado	wdfdriver.h
IRQL	PASSIVE_LEVEL

Consulte también

WdfDriverOpenParametersRegistryKey

IoOpenDriverRegistryKey

DRIVER_REGKEY_TYPE