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)

Voir aussi

UNICODE_STRING

WdfDriverCréer

WdfDriverOpenParametersRegistryKey

WdfGetDriver