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 ACCESS_MASK que representa los derechos de acceso necesarios para la clave. Consulte ZwCreateKey para obtener una descripción de cada KEY_XXX derecho de acceso.
[in] Flags
Establézcalo en cero.
[out] DriverRegKey
Puntero a la variable HANDLE que, al devolverse correctamente, contiene un identificador de la clave del Registro solicitada.
Valor devuelto
ioOpenDriverRegistryKey devuelve STATUS_SUCCESS si la llamada abrió correctamente un identificador a la clave del Registro solicitada.
Observaciones
El controlador debe llamar a ZwClose para cerrar el identificador devuelto de esta rutina cuando el acceso ya no sea necesario.
Las claves del Registro abiertas por esta rutina no son volátiles.
Para aprovisionar claves y valores en el DriverRegKeyParameters inmutable clave del Registro, use una directiva AddReg de una service-install-section para hacer referencia a una sección de 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 | Valor |
|---|---|
| cliente mínimo admitido | Windows 10, versión 1803 |
| encabezado de | wdm.h (incluya wdm.h, ntddk.h o ntifs.h) |
| biblioteca de | NtosKrnl.lib |
| DLL de | NtosKrnl.exe |
| irQL | PASSIVE_LEVEL |