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 de 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. Normalmente, um driver KMDF solicita KEY_READ, KEY_WRITE ou 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.

Retornar valor

Consulte WdfDriverOpenParametersRegistryKey.

Comentários

A Parameters chave é para configurações 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

Confira também

WdfDriverOpenParametersRegistryKey

IoOpenDriverRegistryKey

DRIVER_REGKEY_TYPE