Função WdfDriverOpenParametersRegistryKey (wdfdriver.h)
[Aplica-se a KMDF e UMDF]
O método WdfDriverOpenParametersRegistryKey abre a chave Parameters do registro do driver e recupera um identificador para um objeto de chave de registro da estrutura que representa a chave.
Sintaxe
NTSTATUS WdfDriverOpenParametersRegistryKey(
[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 ACCESS_MASKdigitado que especifica uma máscara de acesso para a chave do Registro Parâmetros.
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
WdfDriverOpenParametersRegistryKey retornará STATUS_SUCCESS se a operação for bem-sucedida. Os valores de retorno adicionais incluem:
Para obter mais informações sobre valores retornados, consulte Erros de Criação de Objeto da Estrutura.
Esse método também pode retornar outros valores NTSTATUS .
Uma verificação de bugs do sistema ocorrerá se um driver KMDF especificar um identificador inválido no do Driver do.
Observações
A chave parâmetros de do driver está localizada na árvore de dos Serviços do Registro. Se a chave parâmetros de do driver não existir, o método WdfDriverOpenParametersRegistryKey a criará.
Quando o driver terminar de usar a chave do Registro parâmetros, o driver deverá chamar WdfRegistryClose.
Observação
O UMDF não dá suporte à criação de subchaves.
Para obter mais informações sobre o registro, consulte Usando o Registro nodrivers Framework-Based.
Exemplos
O exemplo de código a seguir abre os parâmetros de um driver chave do Registro e obtém um identificador para um objeto de chave de registro da estrutura que representa a chave.
WDFKEY hKey;
status = WdfDriverOpenParametersRegistryKey(
Driver,
STANDARD_RIGHTS_ALL,
WDF_NO_OBJECT_ATTRIBUTES,
&hKey
);
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Universal |
| versão mínima do KMDF | 1.0 |
| versão mínima do UMDF | 2.0 |
| cabeçalho | wdfdriver.h (inclua Wdf.h) |
| Biblioteca | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | PASSIVE_LEVEL |
| regras de conformidade de DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |