FltQueryVolumeInformation-Funktion (fltkernel.h)

Artikel
08/07/2023

Die FltQueryVolumeInformation-Routine ruft Informationen über das Volume ab, an das die angegebene instance angefügt ist.

Syntax

NTSTATUS FLTAPI FltQueryVolumeInformation(
  [in]  PFLT_INSTANCE        Instance,
  [out] PIO_STATUS_BLOCK     Iosb,
  [out] PVOID                FsInformation,
  [in]  ULONG                Length,
  [in]  FS_INFORMATION_CLASS FsInformationClass
);

Parameter

[in] Instance

Ein undurchsichtiger instance Zeiger für einen Minifiltertreiber instance, der an das Volume angefügt ist.

[out] Iosb

Ein Zeiger auf die vom Aufrufer zugewiesene IO_STATUS_BLOCK-Struktur, die die endgültige Abschluss-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 werden, im Information-Element 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

Die Größe des Puffers in Byte, auf den FsInformation zeigt. Der Aufrufer sollte diesen Parameter entsprechend der angegebenen FsInformationClass festlegen. Wenn der Wert von FsInformationClass beispielsweise FileFsControlInformation ist, muss Length mindestens sizeof(FILE_FS_CONTROL_INFORMATION) sein.

[in] FsInformationClass

Der Typ der angeforderten Informationen. Einer der folgenden Werte.

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 FltQueryVolumeInformation aufgerufen wird.
FileFsFullSizeInformation	Gibt eine FILE_FS_FULL_SIZE_INFORMATION-Struktur zurück, die Informationen über den gesamt verfügbaren Speicherplatz 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. Hinweis Dieser Wert ist für Momentaufnahme Volumes ungültig.
FileFsSizeInformation	Gibt eine FILE_FS_SIZE_INFORMATION-Struktur zurück, die Informationen über den Speicherplatz auf dem Volume enthält, der für den 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 zu den physischen und logischen Sektorgrößen eines Volumes enthält.

Rückgabewert

Die FltQueryVolumeInformation-Routine gibt STATUS_SUCCESS oder einen geeigneten NTSTATUS-Wert zurück, z. B. einen der folgenden:

Rückgabecode	Beschreibung
STATUS_INSUFFICIENT_RESOURCES	Bei FltQueryVolumeInformation ist ein Poolzuordnungsfehler aufgetreten. Dies ist ein Fehlercode.
STATUS_INVALID_INFO_CLASS	Für FsInformationClass wurde ein ungültiger Wert angegeben. Dies ist ein Fehlercode.
STATUS_INVALID_PARAMETER	Die Instanz wird an ein Netzwerkvolume angefügt. FltQueryVolumeInformation kann nicht zum Abfragen von Netzwerkvolumeinformationen verwendet werden. Dies ist ein Fehlercode.

Hinweise

Felder in der struktur FILE_XXX_INFORMATION, die vom zugrunde liegenden Dateisystem nicht unterstützt werden, werden auf Null festgelegt.

Um Informationen zu einem Volume zu ändern, rufen Sie FltSetVolumeInformation auf.

Rufen Sie FltGetVolumeProperties auf, um Volumeeigenschafteninformationen für das angegebene Volume abzurufen.

Um den Volumenamen für ein bestimmtes Volume abzurufen, rufen Sie FltGetVolumeName auf.

Um den Namen der Volume-GUID für ein bestimmtes Volume abzurufen, rufen Sie FltGetVolumeGuidName auf.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar und unterstützt in Microsoft Windows 2000 Update Rollup 1 für SP4, Windows XP mit Service Pack 2 (SP2), Windows Server 2003 SP1 und höher Windows-Betriebssystemen. Nicht verfügbar oder unterstützt in Windows 2000 SP4 und früheren Windows-Betriebssystemen.
Zielplattform	Universell
Header	fltkernel.h (fltKernel.h einschließen)
Bibliothek	FltMgr.lib
DLL	Fltmgr.sys
IRQL	PASSIVE_LEVEL