Función IoOpenDriverRegistryKey (wdm.h)
La rutina IoOpenDriverRegistryKey devuelve un identificador a una clave del Registro específica del controlador para un controlador determinado.
Sintaxis
NTSTATUS IoOpenDriverRegistryKey(
[in] PDRIVER_OBJECT DriverObject,
[in] DRIVER_REGKEY_TYPE RegKeyType,
[in] ACCESS_MASK DesiredAccess,
[in] ULONG Flags,
[out] PHANDLE DriverRegKey
);
Parámetros
[in] DriverObject
Puntero a una estructura de DRIVER_OBJECT . Esta estructura debe ser el objeto de controlador para el controlador que llama.
[in] RegKeyType
Enumeración de tipo DRIVER_REGKEY_TYPE que indica el tipo de la clave del Registro solicitada.
[in] DesiredAccess
Especifica el valor de ACCESS_MASK que representa los derechos de acceso necesarios para la clave. Consulte ZwCreateKey para obtener una descripción de cada derecho de acceso KEY_XXX.
[in] Flags
Establecer en cero.
[out] DriverRegKey
Puntero a la variable HANDLE que, al devolverse correctamente, contiene un identificador para la clave del Registro solicitada.
Valor devuelto
IoOpenDriverRegistryKey devuelve STATUS_SUCCESS si la llamada abrió correctamente un identificador a la clave del Registro solicitada.
Comentarios
El controlador debe llamar a ZwClose para cerrar el identificador devuelto de esta rutina cuando el acceso ya no es necesario.
Las claves del Registro abiertas por esta rutina no son volátiles.
Para aprovisionar claves y valores en la clave del Registro DriverRegKeyParameters inmutable, use una directiva AddReg de una sección service-install-section para hacer referencia a una sección add-registry-section que contiene entradas con una raíz reg de HKR y una subclave de Parameters.
Los autores de llamadas de IoOpenDriverRegistryKey deben ejecutarse en IRQL = PASSIVE_LEVEL en el contexto de un subproceso del sistema.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 10, versión 1803 |
| Encabezado | wdm.h (incluya wdm.h, ntddk.h o ntifs.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |