WdfDriverRetrieveDriverDataDirectoryString, fonction (wdfdriver.h)

[S’applique uniquement à UMDF]

La méthode WdfDriverRetrieveDriverDataDirectoryString retourne un chemin d’accès à un répertoire sur le 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 de framework du pilote que le pilote a obtenu à partir d’un appel précédent à WdfDriverCreate ou WdfDeviceGetDriver.

[_In_] String

Handle vers un objet de chaîne d’infrastructure que le pilote a obtenu à partir d’un appel précédent à WdfStringCreate. L’infrastructure affecte le chemin complet du répertoire de pilotes demandé à l’objet chaîne.

Valeur de retour

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 Using String Objects.

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

Spécifications

Voir aussi

IoGetDriverDirectory

_DRIVER_DIRECTORY_TYPE énumération