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 |