Partager via


WdfDriverGetRegistryPath, fonction (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 de pilote framework du pilote, obtenu par un appel précédent à WdfDriverCreate ou WdfGetDriver.

Valeur de retour

WdfDriverGetRegistryPath retourne un pointeur vers une chaîne Unicode terminée par NULL qui représente le chemin du Registre du pilote. Une vérification des bogues système se produit si le handle pilote n’est pas valide.

Remarques

La chaîne de chemin d’accès du Registre qui WdfDriverGetRegistryPath retourne est obtenue à partir de la structure UNICODE_STRING que le pilote a reçue comme entrée à sa routine DriverEntry.

Pour plus d’informations sur le Registre, consultez Utilisation du Registre dans Framework-Based Pilotes.

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

Spécifications

Besoin Valeur
plateforme cible Universel
version minimale de KMDF 1.0
version minimale de UMDF 2.0
En-tête wdfdriver.h (include 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

WdfDriverCreate

WdfDriverOpenParametersRegistryKey

WdfGetDriver