WdfRegistryWdmGetHandle, fonction (wdfregistry.h)

[S’applique à KMDF et UMDF]

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

Syntaxe

HANDLE WdfRegistryWdmGetHandle(
  [in] WDFKEY Key
);

Paramètres

[in] Key

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

Valeur retournée

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

Un bogue case activée 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 un HKEY, comme RegEnumKeyEx.

Le handle retourné par la méthode WdfRegistryWdmGetHandle 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 tant que la fonction de rappel n’est pas retournée.

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

Exemples

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

HANDLE hKey;

hKey = WdfRegistryWdmGetHandle(Key);

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
Version KMDF minimale	1.0
Version UMDF minimale	2.0
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)