Compartir a través de

Función IoOpenDriverRegistryKey (wdm.h)

  • Artículo

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

Consulte también

ZwClose

ACCESS_MASK

DRIVER_REGKEY_TYPE