Función WdfRegistryWdmGetHandle (wdfregistry.h)

[Se aplica a KMDF y UMDF]

El método WdfRegistryWdmGetHandle devuelve un controlador de Windows Driver Model (WDM) a la clave del Registro que representa un objeto de clave del Registro de marco especificado.

Sintaxis

HANDLE WdfRegistryWdmGetHandle(
  [in] WDFKEY Key
);

Parámetros

[in] Key

Identificador de un objeto de clave del Registro que representa una clave del Registro abierta.

Valor devuelto

WdfRegistryWdmGetHandle devuelve un identificador WDM a una clave del Registro.

Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.

Comentarios

Un controlador KMDF puede pasar el controlador WDM devuelto a las rutinas ZwXxx que aceptan un controlador WDM como entrada.

Un controlador UMDF puede pasar el identificador devuelto a las API que requieren un HKEY, como RegEnumKeyEx.

El identificador que devuelve el método WdfRegistryWdmGetHandle es válido hasta que se elimina el objeto de clave del Registro. Si el controlador proporciona una función EvtCleanupCallback para el objeto de clave del Registro, el puntero es válido hasta que se devuelve la función de devolución de llamada.

Para obtener más información sobre los objetos de clave del Registro, vea Uso del Registro en controladores de Framework-Based.

Ejemplos

En el ejemplo de código siguiente se obtiene un identificador WDM para la clave del Registro que representa un objeto de clave del Registro de marco especificado.

HANDLE hKey;

hKey = WdfRegistryWdmGetHandle(Key);

Requisitos

Requisito	Value
Plataforma de destino	Universal
Versión mínima de KMDF	1.0
Versión mínima de UMDF	2.0
Encabezado	wdfregistry.h (incluir Wdf.h)
Library	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	PASSIVE_LEVEL
Reglas de cumplimiento de DDI	DriverCreate(kmdf)