FSCTL_QUERY_FILE_REGIONS IOCTL (ntifs.h)

Artikel
11/14/2023

FSCTL_QUERY_FILE_REGIONS fragt basierend auf einem angegebenen Verwendungsparameter eine Liste von Dateiregionen für die Datei ab, die dem Handle zugeordnet ist, für das diese FSCTL aufgerufen wurde. Diese Nachricht enthält ein optionales FILE_REGION_INPUT Datenelement. Wenn kein FILE_REGION_INPUT Parameter angegeben ist, werden Informationen für die gesamte Größe der Datei zurückgegeben.

Hauptcode

FSCTL_QUERY_FILE_REGIONS

Eingabepuffer

Zeiger auf eine FILE_REGION_INPUT-Struktur , die die abzufragenden Dateiregionen angibt.

Eingabepufferlänge

Größe der FILE_REGION_INPUT Struktur, auf die InputBuffer verweist, in Bytes.

Ausgabepuffer

Zeiger auf eine FILE_REGION_OUTPUT Struktur, in der die Ergebnisse der Abfrage zurückgegeben werden.

Länge des Ausgabepuffers

Größe des Puffers, auf den OutputBuffer verweist, in Bytes.

Eingabe-/Ausgabepuffer

–

Länge des Eingabe-/Ausgabepuffers

–

Statusblock

Ist für das System reserviert.

Hinweise

Um diesen Vorgang auszuführen, rufen Sie FltFsControlFile oder ZwFsControlFile mit den folgenden Parametern auf.

Parameter	BESCHREIBUNG
Instanz	[in] Nur für FltFsControlFile . Ein undurchsichtiger instance Zeiger für den Aufrufer. Dieser Parameter ist erforderlich und darf nicht NULL sein.
FileObject	[in] Nur für FltFsControlFile . Ein Dateiobjektzeiger für die Datei oder das Verzeichnis, das das Ziel dieser Anforderung ist. Dieser Parameter ist erforderlich und darf nicht NULL sein.
Filehandle	[in] Nur für ZwFsControlFile . Dateihandle der Datei oder des Verzeichnisses, das das Ziel dieser Anforderung ist. Dieser Parameter ist erforderlich und darf nicht NULL sein.
IoStatusBlock	[out] Nur für ZwFsControlFile . Zeiger auf eine IO_STATUS_BLOCK-Struktur, in der die endgültige status der Anforderung zurückgegeben wird.
FsControlCode	[in] Legen Sie auf FSCTL_QUERY_FILE_REGIONS fest.
Inputbuffer	[in/optional] Zeiger auf eine FILE_REGION_INPUT-Struktur , die die abzufragenden Dateiregionen angibt.
InputBufferLength	[in] Größe des Puffers, auf den InputBuffer verweist, in Bytes.
OutputBuffer	[out] Zeiger auf eine FILE_REGION_OUTPUT Struktur, in der die Ergebnisse der Abfrage zurückgegeben werden.
OutputBufferLength	[out] Größe des Puffers, auf den OutputBuffer verweist, in Bytes.
LengthReturned	[out] Zeiger auf eine vom Aufrufer zugewiesene Variable, die die Größe der im Puffer bei OutputBuffer zurückgegebenen Informationen in Bytes empfängt.

Rückgabewerte

FSCTL_QUERY_FILE_REGIONS gibt nach erfolgreichem Abschluss STATUS_SUCCESS zurück. Andernfalls wird ein Fehlercode zurückgegeben. Nach erfolgreichem Abschluss sollte der Aufrufer zuerst überprüfen, ob IoStatus.Information größer oder gleich LengthReturned ist, bevor er auf die in OutputBuffer zurückgegebenen Informationen zugreift.