Fonction WdfDriverGetRegistryPath (wdfdriver.h)
[S’applique à KMDF et UMDF]
La méthode WdfDriverGetRegistryPath récupère le chemin d’accès à la clé de Registre du pilote dans l’arborescence Services du Registre.
Syntaxe
PWSTR WdfDriverGetRegistryPath(
[in] WDFDRIVER Driver
);
Paramètres
[in] Driver
Handle de l’objet pilote d’infrastructure du pilote, obtenu par un appel précédent à WdfDriverCreate ou WdfGetDriver.
Valeur retournée
WdfDriverGetRegistryPath retourne un pointeur vers une chaîne Unicode terminée par NULL qui représente le chemin du Registre du pilote. Un bogue système case activée se produit si le handle du pilote n’est pas valide.
Remarques
La chaîne de chemin du Registre retournée par WdfDriverGetRegistryPath est obtenue à partir de la structure UNICODE_STRING que le pilote a reçue en tant qu’entrée dans sa routine DriverEntry .
Pour plus d’informations sur le Registre, consultez Utilisation du Registre dans les pilotes Framework-Based.
Exemples
L’exemple de code suivant obtient le chemin d’accès à la clé de Registre d’un pilote dans l’arborescence Services du Registre.
PWSTR registryPath;
registryPath = WdfDriverGetRegistryPath(driver);
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| Version KMDF minimale | 1.0 |
| Version UMDF minimale | 2.0 |
| En-tête | wdfdriver.h (inclure Wdf.h) |
| Bibliothèque | Wdf01000.sys (KMDF) ; WUDFx02000.dll (UMDF) |
| IRQL | PASSIVE_LEVEL |
| Règles de conformité DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |