WdfDriverRetrieveDriverDataDirectoryString, fonction (wdfdriver.h)
[S’applique uniquement à UMDF]
La méthode WdfDriverRetrieveDriverDataDirectoryString retourne un chemin d’accès à un répertoire sur disque dans lequel le pilote peut stocker des informations. Les fichiers de ce répertoire s’appliquent à un objet de pilote d’infrastructure spécifique.
Syntaxe
NTSTATUS WdfDriverRetrieveDriverDataDirectoryString(
[_In_] WDFDRIVER Driver,
[_In_] WDFSTRING String
);
Paramètres
[_In_] Driver
Handle de l’objet de pilote d’infrastructure du pilote que le pilote a obtenu à partir d’un appel précédent à WdfDriverCreate ou WdfDeviceGetDriver.
[_In_] String
Handle pour un objet de chaîne de framework que le pilote a obtenu à partir d’un appel précédent à WdfStringCreate. L’infrastructure affecte le chemin complet du répertoire du pilote demandé à l’objet string.
Valeur retournée
WdfDriverRetrieveDriverDataDirectoryString retourne STATUS_SUCCESS si l’opération réussit. Sinon, cette méthode retourne un code d’erreur NTSTATUS approprié. Pour plus d’informations, consultez Valeurs NTSTATUS.
Remarques
Pour obtenir le même résultat, un pilote KMDF doit appeler IoGetDriverDirectory à la place.
Pour plus d’informations sur les objets de chaîne, consultez Utilisation d’objets de chaîne.
Exemples
L’exemple de code suivant montre comment appeler WdfDriverRetrieveDriverDataDirectoryString :
NTSTATUS status;
WDFSTRING string;
status = WdfStringCreate(
NULL,
WDF_NO_OBJECT_ATTRIBUTES,
&string
);
if (NT_SUCCESS(status)) {
status = WdfDriverRetrieveDriverDataDirectoryString(
Driver,
string
);
if (!NT_SUCCESS(status)) {
return status;
}
}
Configuration requise
| Condition requise | Valeur |
|---|---|
| Version UMDF minimale | 2,27 |
| En-tête | wdfdriver.h |
| IRQL | PASSIVE_LEVEL |