Função WdfFdoInitOpenRegistryKey (wdffdo.h)

[Aplica-se a KMDF e UMDF]

O método WdfFdoInitOpenRegistryKey abre a chave de hardware de um dispositivo ou a chave de software de um driver no registro e cria um objeto de chave do Registro de estrutura que representa a chave do Registro.

Sintaxe

NTSTATUS WdfFdoInitOpenRegistryKey(
  [in]           PWDFDEVICE_INIT        DeviceInit,
  [in]           ULONG                  DeviceInstanceKeyType,
  [in]           ACCESS_MASK            DesiredAccess,
  [in, optional] PWDF_OBJECT_ATTRIBUTES KeyAttributes,
  [out]          WDFKEY                 *Key
);

Parâmetros

[in] DeviceInit

Um ponteiro para uma estrutura WDFDEVICE_INIT que o driver obteve de sua função de retorno de chamada EvtDriverDeviceAdd .

[in] DeviceInstanceKeyType

Especifica qual chave ou subchave abrir.

Esse é um OR bit a bit dos sinalizadores a seguir (que são definidos em Wdm.h).

[in] DesiredAccess

Um valor de tipo ACCESS_MASK que especifica os direitos de acesso que o driver está solicitando para a chave do Registro especificada.

Um driver KMDF normalmente solicita KEY_READ, KEY_WRITE ou KEY_READ | KEY_WRITE.

Se você estiver escrevendo um driver UMDF, use a tabela a seguir.

Como prática recomendada, peça apenas os tipos de acesso que seu driver precisa.

[in, optional] KeyAttributes

Um ponteiro para uma estrutura WDF_OBJECT_ATTRIBUTES que contém atributos fornecidos pelo driver para o novo objeto registry-key. Esse parâmetro é opcional e pode ser WDF_NO_OBJECT_ATTRIBUTES.

[out] Key

Um ponteiro para um local que recebe um identificador para o novo objeto de chave do Registro.

Retornar valor

WdfFdoInitOpenRegistryKey retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, o método poderá retornar um dos seguintes valores:

Para obter uma lista de outros valores retornados que o método WdfFdoInitOpenRegistryKey pode retornar, consulte Erros de criação de objeto de estrutura.

O método também pode retornar outros valores NTSTATUS.

Comentários

O driver deve chamar WdfFdoInitOpenRegistryKey antes de chamar WdfDeviceCreate. Para obter mais informações sobre como chamar WdfDeviceCreate, consulte Criando um objeto de dispositivo de estrutura.

Para obter mais informações sobre o método WdfFdoInitOpenRegistryKey , consulte Criando objetos de dispositivo em um driver de função.

ou mais informações sobre o registro, chaves de hardware e software e objetos do Registro, consulte Usando o Registro em drivers de Framework-Based.

Exemplos

O exemplo de código a seguir abre a chave de hardware de um dispositivo, com acesso de leitura.

WDFKEY key;
NTSTATUS status;

status = WdfFdoInitOpenRegistryKey(
                                   DeviceInit,
                                   PLUGPLAY_REGKEY_DEVICE,
                                   GENERIC_READ,
                                   WDF_NO_OBJECT_ATTRIBUTES,
                                   &key
                                   );
if (!NT_SUCCESS(status)) {
    return status;
}

Requisitos

Confira também

WdfDeviceOpenRegistryKey

WdfDriverOpenParametersRegistryKey