Função WdfDriverOpenPersistentStateRegistryKey (wdfdriver.h)
Os drivers devem usar WdfDriverOpenPersistentStateRegistryKey para gravar informações persistentes do driver no registro.
Sintaxe
NTSTATUS WdfDriverOpenPersistentStateRegistryKey(
[in] WDFDRIVER Driver,
[in] ACCESS_MASK DesiredAccess,
[in, optional] PWDF_OBJECT_ATTRIBUTES KeyAttributes,
[out] WDFKEY *Key
);
Parâmetros
[in] Driver
Um identificador para o objeto de driver da estrutura do driver que o driver obteve de uma chamada anterior para WdfDriverCreate ou WdfGetDriver.
[in] DesiredAccess
Um valor digitado ACCESS_MASK que especifica uma máscara de acesso para a chave do Registro. Um driver KMDF normalmente solicita KEY_READ, KEY_WRITEou KEY_READ | KEY_WRITE. Se você estiver escrevendo um driver UMDF, use KEY_READ ou KEY_READ | KEY_SET_VALUE. Como prática recomendada, peça apenas os tipos de acesso necessários ao driver.
[in, optional] KeyAttributes
Um ponteiro para uma estrutura de WDF_OBJECT_ATTRIBUTES alocada pelo chamador que especifica atributos de objeto para o objeto de chave de registro da estrutura. Esse parâmetro é opcional e pode ser WDF_NO_OBJECT_ATTRIBUTES.
[out] Key
Um ponteiro para um local que recebe um identificador para um objeto de chave de registro da estrutura.
Valor de retorno
Consulte WdfDriverOpenParametersRegistryKey .
Observações
A chave Parameters é para configurações de imutáveis fornecidas no arquivo INF. Para acessar essas configurações, use WdfDriverOpenParametersRegistryKey . A chave retornada dessa API é para configurações gravadas em runtime.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 10, versão 1803 |
| versão mínima do KMDF | 1.25 |
| versão mínima do UMDF | 2.25 |
| cabeçalho | wdfdriver.h |
| IRQL | PASSIVE_LEVEL |