Função WdfRegistryWdmGetHandle (wdfregistry.h)

[Aplica-se a KMDF e UMDF]

O método WdfRegistryWdmGetHandle retorna um identificador WDM (Modelo de Driver do Windows) para a chave do Registro que um objeto de chave de registro de estrutura especificado representa.

Sintaxe

HANDLE WdfRegistryWdmGetHandle(
  [in] WDFKEY Key
);

Parâmetros

[in] Key

Um identificador para um objeto de chave do Registro que representa uma chave do Registro aberta.

Retornar valor

WdfRegistryWdmGetHandle retorna um identificador WDM para uma chave do Registro.

Um bug marcar ocorrerá se o driver fornecer um identificador de objeto inválido.

Comentários

Um driver KMDF pode passar o identificador WDM retornado para as rotinas ZwXxx que aceitam um identificador WDM como entrada.

Um driver UMDF pode passar o identificador retornado para APIs que exigem um HKEY, como RegEnumKeyEx.

O identificador que o método WdfRegistryWdmGetHandle retorna é válido até que o objeto registry-key seja excluído. Se o driver fornecer uma função EvtCleanupCallback para o objeto registry-key, o ponteiro será válido até que a função de retorno de chamada retorne.

Para obter mais informações sobre objetos de chave do Registro, consulte Usando o Registro em drivers de Framework-Based.

Exemplos

O exemplo de código a seguir obtém um identificador WDM para a chave do Registro que um objeto de chave de registro de estrutura especificado representa.

HANDLE hKey;

hKey = WdfRegistryWdmGetHandle(Key);

Requisitos

Requisito	Valor
Plataforma de Destino	Universal
Versão mínima do KMDF	1.0
Versão mínima do UMDF	2,0
Cabeçalho	wdfregistry.h (inclua Wdf.h)
Biblioteca	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	PASSIVE_LEVEL
Regras de conformidade de DDI	DriverCreate(kmdf)