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
| Anforderung | Wert |
|---|---|
| UMDF-Mindestversion | 2.27 |
| Kopfzeile | wdfdriver.h |
| IRQL | PASSIVE_LEVEL |