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.

Observaciones

Un controlador KMDF puede pasar el identificador WDM devuelto a las rutinas de ZwXxx que aceptan un identificador 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 Using the Registry in Framework-Based Drivers.

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	Valor
de la plataforma de destino de	Universal
versión mínima de KMDF	1.0
versión mínima de UMDF	2.0
encabezado de	wdfregistry.h (incluya Wdf.h)
biblioteca de	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
irQL	PASSIVE_LEVEL
reglas de cumplimiento de DDI	DriverCreate(kmdf)