IoVolumeDeviceToDosName-Funktion (ntddk.h)

Artikel
02/26/2024

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.