FltQueryVolumeInformationFile-Funktion (fltkernel.h)

Artikel
02/06/2025

FltQueryVolumeInformationFile Volumeinformationen für eine bestimmte Datei, ein Verzeichnis, ein Speichergerät oder ein Volume abruft.

Syntax

NTSTATUS FLTAPI FltQueryVolumeInformationFile(
  [in]            PFLT_INSTANCE        Instance,
  [in]            PFILE_OBJECT         FileObject,
  [out]           PVOID                FsInformation,
  [in]            ULONG                Length,
  [in]            FS_INFORMATION_CLASS FsInformationClass,
  [out, optional] PULONG               LengthReturned
);

Parameter

[in] Instance

Undurchsichtiger Instanzzeiger für den Aufrufer. Dieser Parameter ist erforderlich und kann nicht NULL-werden.

[in] FileObject

Dateiobjektzeiger für eine geöffnete Datei, ein Verzeichnis, ein Speichergerät oder ein Volume. Dieser Parameter ist erforderlich und kann nicht NULL-werden.

[out] FsInformation

Zeigen Sie auf einen vom Aufrufer zugewiesenen Puffer, der Informationen über die Datei empfängt. Der FsInformationClass Parameter gibt den Informationstyp an. Dieser Parameter ist erforderlich und kann nicht NULL-werden.

[in] Length

Größe des FsInformation- Puffers in Bytes.

[in] FsInformationClass

Typ der Volumeinformationen, die zurückgegeben werden sollen. Eine der folgenden:

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 Informationen zur Dateisystemsteuerung über das 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 FltQueryVolumeInformationFileaufgerufen 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 eindeutigen Volumenamen (GUID-basiert) übereinstimmt, 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 zur Verfügung steht, der dem aufrufenden Thread zugeordnet ist.
FileFsVolumeInformation	Gibt einen FILE_FS_VOLUME_INFORMATION zurück, der Informationen zum Volume enthält, z. B. die Volumebezeichnung, die Seriennummer und die 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.

[out, optional] LengthReturned

Zeiger auf eine vom Aufrufer zugewiesene Variable, die die Größe der im FsInformation Puffer zurückgegebenen Informationen in Byte empfängt. Dieser Parameter ist optional und kann NULL-werden.

Rückgabewert

FltQueryVolumeInformationFile gibt STATUS_SUCCESS oder einen geeigneten NTSTATUS- Wert wie den folgenden zurück:

Rückgabecode	Beschreibung
STATUS_VOLUME_DISMOUNTED	Das Volume wird derzeit nicht bereitgestellt. Dies ist ein Fehlercode.

Bemerkungen

FltQueryVolumeInformationFile Volumeinformationen für eine bestimmte Datei, ein Verzeichnis, ein Speichergerät oder ein Volume abruft.

Wenn das FileObject- ein direktes Gerät darstellt, kann nur FileFsDeviceInformation- als Wert von FsInformationClassangegeben werden.

FltQueryVolumeInformationFile gibt null in einem Element einer FILE_FS_XXX-_INFORMATION-Struktur zurück, die von einem bestimmten Dateisystem nicht unterstützt wird.