Funzione WdfRegistryWdmGetHandle (wdfregistry.h)

Articolo
02/07/2025

[Si applica a KMDF e UMDF]

Il metodo WdfRegistryWdmGetHandle restituisce un handle WDM (Windows Driver Model) sulla 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 di 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.

Osservazioni

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 Using the Registry in Framework-Based Drivers.

Esempi

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);

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
versione minima di KMDF	1.0
versione minima di UMDF	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