WdfDriverRetrieveDriverDataDirectoryString-Funktion (wdfdriver.h)

[Gilt nur für UMDF]

Die WdfDriverRetrieveDriverDataDirectoryString-Methode gibt einen Pfad zu einem Verzeichnis auf dem Datenträger zurück, in dem der Treiber Informationen speichern kann. Die Dateien in diesem Verzeichnis gelten für ein bestimmtes Frameworktreiberobjekt.

Syntax

NTSTATUS WdfDriverRetrieveDriverDataDirectoryString(
  [_In_] WDFDRIVER Driver,
  [_In_] WDFSTRING String
);

Parameter

[_In_] Driver

Ein Handle für das Frameworktreiberobjekt des Treibers, das der Treiber aus einem vorherigen Aufruf von WdfDriverCreate oder WdfDeviceGetDriver abgerufen hat.

[_In_] String

Ein Handle für ein Frameworkzeichenfolgenobjekt, das der Treiber aus einem vorherigen Aufruf von WdfStringCreate abgerufen hat. Das Framework weist dem Zeichenfolgenobjekt den vollqualifizierten Pfad des angeforderten Treiberverzeichnisses zu.

Rückgabewert

WdfDriverRetrieveDriverDataDirectoryString gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Methode einen geeigneten NTSTATUS-Fehlercode zurück. Weitere Informationen finden Sie unter NTSTATUS-Werte.

Hinweise

Um das gleiche Ergebnis zu erzielen, sollte ein KMDF-Treiber stattdessen IoGetDriverDirectory aufrufen.

Weitere Informationen zu Zeichenfolgenobjekten finden Sie unter Verwenden von Zeichenfolgenobjekten.

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie WdfDriverRetrieveDriverDataDirectoryString aufgerufen wird:

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

Anforderungen

Weitere Informationen

IoGetDriverDirectory

_DRIVER_DIRECTORY_TYPE-Enumeration