WdfRegistryWdmGetHandle, fonction (wdfregistry.h)

[S’applique à KMDF et UMDF]

La méthode WdfRegistryWdmGetHandle retourne un handle WDM (Windows Driver Model) à la clé de Registre qu’un objet de clé de registre d’infrastructure spécifié représente.

Syntaxe

HANDLE WdfRegistryWdmGetHandle(
  [in] WDFKEY Key
);

Paramètres

[in] Key

Handle vers un objet de clé de Registre qui représente une clé de Registre ouverte.

Valeur de retour

WdfRegistryWdmGetHandle retourne un handle WDM à une clé de Registre.

Une vérification de bogue se produit si le pilote fournit un handle d’objet non valide.

Remarques

Un pilote KMDF peut passer le handle WDM retourné aux routines ZwXxx qui acceptent un handle WDM comme entrée.

Un pilote UMDF peut passer le handle retourné aux API qui nécessitent une clé HKEY, telle que RegEnumKeyEx.

Handle que la méthode WdfRegistryWdmGetHandle retourne est valide jusqu’à ce que l’objet de clé de Registre soit supprimé. Si le pilote fournit une fonction EvtCleanupCallback pour l’objet de clé de Registre, le pointeur est valide jusqu’à ce que la fonction de rappel retourne.

Pour plus d’informations sur les objets de clé de Registre, consultez Utilisation du Registre dans Framework-Based Drivers.

Exemples

L’exemple de code suivant obtient un handle WDM à la clé de Registre qu’un objet de clé de registre d’infrastructure spécifié représente.

HANDLE hKey;

hKey = WdfRegistryWdmGetHandle(Key);

Exigences

Exigence	Valeur
plateforme cible	Universel
version minimale de KMDF	1.0
version minimale de UMDF	2.0
d’en-tête	wdfregistry.h (include Wdf.h)
bibliothèque	Wdf01000.sys (KMDF) ; WUDFx02000.dll (UMDF)
IRQL	PASSIVE_LEVEL
règles de conformité DDI	DriverCreate(kmdf)