ZwQueryVolumeInformationFile-Funktion (ntifs.h)

Artikel
02/29/2024

Die ZwQueryVolumeInformationFile-Routine ruft Informationen über das Volume ab, das einer bestimmten Datei, einem verzeichnis, einem speicherfähigen Gerät oder volume zugeordnet ist.

Syntax

NTSYSAPI NTSTATUS ZwQueryVolumeInformationFile(
  [in]  HANDLE               FileHandle,
  [out] PIO_STATUS_BLOCK     IoStatusBlock,
  [out] PVOID                FsInformation,
  [in]  ULONG                Length,
  [in]  FS_INFORMATION_CLASS FsInformationClass
);

Parameter

[in] FileHandle

Ein Handle für ein Dateiobjekt, das von ZwCreateFile oder ZwOpenFile für eine geöffnete Datei, ein Verzeichnis, ein Speichergerät oder ein Volume zurückgegeben wird, für das Volumeinformationen angefordert werden.

[out] IoStatusBlock

Ein Zeiger auf eine IO_STATUS_BLOCK-Struktur, die die endgültige Vervollständigung status und Informationen zum Abfragevorgang empfängt. Bei erfolgreichen Aufrufen, die Daten zurückgeben, wird die Anzahl der Bytes, die in den FsInformation-Puffer geschrieben wurden, im Informationselement der Struktur zurückgegeben.

[out] FsInformation

Ein Zeiger auf einen vom Aufrufer zugewiesenen Puffer, der die gewünschten Informationen über das Volume empfängt. Die Struktur der im Puffer zurückgegebenen Informationen wird durch den FsInformationClass-Parameter definiert.

[in] Length

Größe in Bytes des Puffers, auf den fsInformation verweist. Der Aufrufer sollte diesen Parameter entsprechend der angegebenen FsInformationClass festlegen.

[in] FsInformationClass

Typ der Informationen, die über das Volume zurückgegeben werden sollen. Legen Sie diesen Member auf einen der folgenden FS_INFORMATION_CLASS Enumerationswerte fest.

Wert	Bedeutung
FileFsAttributeInformation	Gibt eine FILE_FS_ATTRIBUTE_INFORMATION-Struktur zurück, die Attributinformationen zum Dateisystem enthält, das für das Volume verantwortlich ist.
FileFsControlInformation	Gibt eine FILE_FS_CONTROL_INFORMATION-Struktur zurück, die Dateisystemsteuerungsinformationen zum Volume enthält.
FileFsDeviceInformation	Gibt eine FILE_FS_DEVICE_INFORMATION Struktur zurück, die Geräteinformationen für das Volume enthält.
FileFsDriverPathInformation	Gibt eine FILE_FS_DRIVER_PATH_INFORMATION-Struktur zurück, die Informationen darüber enthält, ob sich ein angegebener Treiber im E/A-Pfad für das Volume befindet. Der Aufrufer muss den Namen des Treibers in der FILE_FS_DRIVER_PATH_INFORMATION-Struktur speichern, bevor ZwQueryVolumeInformationFile aufgerufen wird.
FileFsFullSizeInformation	Gibt eine FILE_FS_FULL_SIZE_INFORMATION-Struktur zurück, die Informationen über die Gesamtmenge des verfügbaren Speicherplatzes auf dem Volume enthält.
FileFsObjectIdInformation	Gibt eine FILE_FS_OBJECTID_INFORMATION-Struktur zurück, die dateisystemspezifische Objekt-ID-Informationen für das Volume enthält. Beachten Sie, dass dies nicht mit dem (GUID-basierten) eindeutigen Volumenamen identisch ist, der vom Betriebssystem zugewiesen wird.
FileFsSizeInformation	Gibt eine FILE_FS_SIZE_INFORMATION-Struktur zurück, die Informationen über den Speicherplatz auf dem Volume enthält, der dem benutzer verfügbar ist, der dem aufrufenden Thread zugeordnet ist.
FileFsVolumeInformation	Gibt einen FILE_FS_VOLUME_INFORMATION zurück, der Informationen zum Volume enthält, z. B. Volumebezeichnung, Seriennummer und Erstellungszeit.
FileFsSectorSizeInformation	Gibt eine FILE_FS_SECTOR_SIZE_INFORMATION-Struktur zurück, die Informationen über die physischen und logischen Sektorgrößen eines Volumes enthält.

Rückgabewert

ZwQueryVolumeInformationFile gibt STATUS_SUCCESS oder einen entsprechenden Fehler status zurück.

Hinweise

ZwQueryVolumeInformationFile ruft Informationen über das Volume ab, das einer bestimmten Datei, einem verzeichnis, einem speicherfähigen Gerät oder volume zugeordnet ist.

Wenn fileHandle ein direkt geöffnetes Gerät darstellt, kann nur FileFsDeviceInformation als Wert von FsInformationClass angegeben werden.

ZwQueryVolumeInformationFile gibt null in jedem Element einer FILE_XXX_INFORMATION-Struktur zurück, die vom Dateisystem nicht unterstützt wird.

Informationen zu anderen Dateiinformationsabfrageroutinen finden Sie unter Dateiobjekte.

Minifilter sollten FltQueryVolumeInformationFile anstelle von ZwQueryVolumeInformationFile verwenden.

Aufrufer von ZwQueryVolumeInformationFile müssen unter IRQL = PASSIVE_LEVEL und mit aktivierten speziellen Kernel-APCs ausgeführt werden.

Hinweis

Wenn der Aufruf der ZwQueryVolumeInformationFile-Funktion im Benutzermodus erfolgt, sollten Sie den Namen "NtQueryVolumeInformationFile" anstelle von "ZwQueryVolumeInformationFile" verwenden.

Bei Aufrufen von Kernelmodustreibern können sich die NtXxx - und ZwXxx-Versionen einer Windows Native System Services-Routine anders verhalten, da sie Eingabeparameter verarbeiten und interpretieren. Weitere Informationen zur Beziehung zwischen den Nt Xxx- und ZwXxx-Versionen einer Routine finden Sie unter Verwenden von Nt- und Zw-Versionen der Systemdienstroutinen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP
Zielplattform	Universell
Header	ntifs.h (include Ntifs.h, Ntddk.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL (siehe Abschnitt Hinweise)
DDI-Complianceregeln	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)