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

Voir aussi

IoGetDriverDirectory

_DRIVER_DIRECTORY_TYPE, énumération