IoQueryFullDriverPath-Funktion (ntddk.h)
Die IoQueryFullDriverPath-Routine ruft den vollständigen Pfadnamen der Binärdatei ab, die für das angegebene Treiberobjekt geladen wird. Ab Windows 10 Version 1709 können Aufrufer Treiberobjekte abfragen, die keine eigenen sind, solange sie die richtige Synchronisierung verwenden, um sicherzustellen, dass die DRIVER_OBJECT-Struktur während des Aufrufs gültig bleibt.
Syntax
NTSTATUS IoQueryFullDriverPath(
[in] PDRIVER_OBJECT DriverObject,
[out] PUNICODE_STRING FullPath
);
Parameter
[in] DriverObject
Ein Zeiger auf eine DRIVER_OBJECT-Struktur . Wenn Sie IoQueryFullDriverPath auf einem Computer aufrufen, auf dem eine frühere Version von Windows 10 als Version 1709 ausgeführt wird, muss diese Struktur das Treiberobjekt für den aufrufenden Treiber sein.
[out] FullPath
Ein Zeiger auf eine aufruferseitig zugeordnete UNICODE_STRING-Struktur . Bei erfolgreicher Rückgabe enthält diese Struktur den Pfadnamen.
Rückgabewert
IoQueryFullDriverPath gibt STATUS_SUCCESS zurück, wenn der Aufruf den Pfadnamen erfolgreich abruft. Mögliche Fehlerrückgabewerte sind die folgenden status Codes.
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_ACCESS_DENIED | Das Zieltreiberobjekt gehört nicht zum Aufrufer. Dieser status Code wird nur in Versionen von Windows 10 vor 1709 zurückgegeben. |
| STATUS_NOT_FOUND | Dem Treiberobjekt ist kein Abschnitt (geladenes Speicherimage) zugeordnet. |
| STATUS_INSUFFICIENT_RESOURCES | Für die Ausführung des angeforderten Vorgangs sind nicht genügend Ressourcen verfügbar. |
Hinweise
Ein Treiber kann diese Routine aufrufen, um den vollständigen Pfadnamen seiner Binärdatei abzufragen, oder ab Windows 10 Version 1709 den vollständigen Pfadnamen der Binärdatei für einen anderen Treiber.
Der Aufrufer ordnet die UNICODE_STRING Struktur zu, auf die der FullPath-Parameter verweist, muss diese Struktur jedoch nicht initialisieren. IoQueryFullDriverPath geht davon aus, dass der ursprüngliche Inhalt dieser Struktur ungültig ist, und überschreibt sie. Diese Routine ordnet einen Zeichenfolgenpuffer aus dem ausgelagerten Systemspeicher zu, legt fest, dass der Buffer-Member der Struktur auf diesen Puffer verweist, und legt die Elemente MaximumLength und Buffer fest, um den Puffer und seinen Inhalt zu beschreiben.
Der Aufrufer ist für das Freigeben des Speichers verantwortlich, auf den FullPath-Buffer> verweist, wenn die vollständige Pfadzeichenfolge nicht mehr benötigt wird. In der Regel gibt der Aufrufer diesen Speicher frei, indem er eine Routine wie ExFreePool aufruft.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar ab Windows 8.1. |
| Zielplattform | Universell |
| Header | ntddk.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |