Funzione WdfRegistryWdmGetHandle (wdfregistry.h)

Articolo
03/05/2024

[Si applica a KMDF e UMDF]

Il metodo WdfRegistryWdmGetHandle restituisce un handle WDM (Windows Driver Model) alla chiave del Registro di sistema rappresentata da un oggetto chiave del Registro di sistema del framework specificato.

Sintassi

HANDLE WdfRegistryWdmGetHandle(
  [in] WDFKEY Key
);

Parametri

[in] Key

Handle per un oggetto chiave del Registro di sistema che rappresenta una chiave del Registro di sistema aperta.

Valore restituito

WdfRegistryWdmGetHandle restituisce un handle WDM a una chiave del Registro di sistema.

Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.

Commenti

Un driver KMDF può passare l'handle WDM restituito alle routine ZwXxx che accettano un handle WDM come input.

Un driver UMDF può passare l'handle restituito alle API che richiedono un HKEY, ad esempio RegEnumKeyEx.

L'handle restituito dal metodo WdfRegistryWdmGetHandle è valido fino all'eliminazione dell'oggetto chiave del Registro di sistema. Se il driver fornisce una funzione EvtCleanupCallback per l'oggetto chiave del Registro di sistema, il puntatore è valido fino a quando non viene restituita la funzione di callback.

Per altre informazioni sugli oggetti chiave del Registro di sistema, vedere Uso del Registro di sistema nei driver Framework-Based.

Esempio

Nell'esempio di codice seguente viene ottenuto un handle WDM per la chiave del Registro di sistema rappresentata da un oggetto chiave del Registro di sistema del framework specificato.

HANDLE hKey;

hKey = WdfRegistryWdmGetHandle(Key);

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Versione KMDF minima	1.0
Versione UMDF minima	2,0
Intestazione	wdfregistry.h (include Wdf.h)
Libreria	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	PASSIVE_LEVEL
Regole di conformità DDI	DriverCreate(kmdf)

Condividi tramite