Função IoOpenDriverRegistryKey (wdm.h)
A rotina IoOpenDriverRegistryKey retorna um identificador para uma chave do Registro específica do driver para um driver específico.
Sintaxe
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
Um ponteiro para uma estrutura DRIVER_OBJECT . Essa estrutura deve ser o objeto driver do driver de chamada.
[in] RegKeyType
Uma enumeração do tipo DRIVER_REGKEY_TYPE que indica o tipo da chave do Registro solicitada.
[in] DesiredAccess
Especifica o valor ACCESS_MASK que representa os direitos de acesso necessários para a chave. Consulte ZwCreateKey para obter uma descrição de cada KEY_XXX direito de acesso.
[in] Flags
Defina como zero.
[out] DriverRegKey
Um ponteiro para a variável HANDLE que, no retorno bem-sucedido, contém um identificador para a chave do Registro solicitada.
Retornar valor
IoOpenDriverRegistryKey retornará STATUS_SUCCESS se a chamada tiver aberto com êxito um identificador para a chave do Registro solicitada.
Comentários
O driver deve chamar ZwClose para fechar o identificador retornado dessa rotina quando o acesso não for mais necessário.
As chaves do Registro abertas por essa rotina não sãovolatile.
Para provisionar chaves e valores na chave do Registro DriverRegKeyParameters imutável, use uma diretiva AddReg de uma seção service-install para fazer referência a uma seção add-registry-section que contém entradas com uma raiz reg de HKR e uma subchave de Parameters.
Os chamadores de IoOpenDriverRegistryKey devem estar em execução em IRQL = PASSIVE_LEVEL no contexto de um thread do sistema.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 10, versão 1803 |
| Cabeçalho | wdm.h (include wdm.h, ntddk.h ou ntifs.h) |
| Biblioteca | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |