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