IoVolumeDeviceToDosName-Funktion (ntddk.h)
Die IoVolumeDeviceToDosName-Routine gibt den MS-DOS-Pfad für ein angegebenes Geräteobjekt zurück, das ein Dateisystemvolume darstellt.
Syntax
NTSTATUS IoVolumeDeviceToDosName(
[in] PVOID VolumeDeviceObject,
[out] PUNICODE_STRING DosName
);
Parameter
[in] VolumeDeviceObject
Ein Zeiger auf ein Geräteobjekt, das ein Volumegerätobjekt darstellt, das von einem Speicherklassentreiber erstellt wurde.
[out] DosName
Ein Zeiger auf eine aufruferseitig zugeordnete UNICODE_STRING-Struktur . Wenn der Aufruf erfolgreich ist, legt IoVolumeDeviceToDosName die Werte der Elemente Length, MaximumLength und Buffer dieser Struktur fest. Beim Beenden zeigt der Buffer-Member auf eine breitzeichenige, NULL-endende Zeichenfolge, die den MS-DOS-Pfad des volume-Geräteobjekts enthält, das von VolumeDeviceObject angegeben wird. Weitere Informationen finden Sie in den Hinweisen.
Rückgabewert
IoVolumeDeviceToDosName gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich ist. Mögliche Fehlerrückgabewerte sind die folgenden status Codes.
| Rückgabewert | BESCHREIBUNG |
|---|---|
| STATUS_INVALID_PARAMETER | Fehler bei der Routine aufgrund ungültiger Parameterwerte, die vom Aufrufer übergeben wurden. |
| STATUS_INSUFFICIENT_RESOURCES | Die Routine konnte die für diesen Vorgang erforderlichen Ressourcen nicht zuordnen. |
Hinweise
IoVolumeDeviceToDosName weist den Zeichenfolgenpuffer zu, auf den der Buffer-Member der UNICODE_STRING Struktur verweist, auf die der DosName-Parameter verweist. Nachdem dieser Puffer nicht mehr benötigt wird, sollte ein Aufrufer dieser Routine die ExFreePool-Routine aufrufen, um den Puffer freizugeben.
Ab Windows Vista müssen Sie sicherstellen, dass APCs nicht deaktiviert sind, bevor Sie diese Routine aufrufen. Die KeAreAllApcsDisabled-Routine kann verwendet werden, um zu überprüfen, ob APCs nicht deaktiviert sind.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| Header | ntddk.h (include Ntddk.h) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |