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

Die Parameter

[_In_] Driver

Ein Handle für das Framework-Treiberobjekt des Treibers, das der Treiber aus einem vorherigen Aufruf von WdfDriverCreate oder WdfDeviceGetDriverabgerufen hat.

[_In_] String

Ein Handle zu einem Framework-Zeichenfolgenobjekt, das der Treiber aus einem vorherigen Aufruf von WdfStringCreateabgerufen 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 Values.

Bemerkungen

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

Weitere Informationen zu Zeichenfolgenobjekten finden Sie unter Verwenden von Zeichenfolgenobjekten.

Beispiele

Das folgende Codebeispiel zeigt, wie WdfDriverRetrieveDriverDataDirectoryStringaufgerufen 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

Anforderung	Wert
Mindest-UMDF-Version	2.27
Kopfzeile	wdfdriver.h
IRQL	PASSIVE_LEVEL

Siehe auch

IoGetDriverDirectory-

_DRIVER_DIRECTORY_TYPE Enumeration