FSCTL_QUERY_FILE_REGIONS IOCTL (ntifs.h)

Artikel
12/21/2024

FSCTL_QUERY_FILE_REGIONS fragt eine Liste der Dateibereiche ab, die auf einem angegebenen Verwendungsparameter basieren, für die Datei, 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 wird, werden Informationen für die gesamte Größe der Datei zurückgegeben.

Hauptcode

FSCTL_QUERY_FILE_REGIONS

Eingabepuffer

Zeigen Sie auf eine FILE_REGION_INPUT Struktur, die die abzufragenden Dateibereiche angibt.

Eingabepufferlänge

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

Ausgabepuffer

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

Länge des Ausgabepuffers

Größe des Puffers, der OutputBuffer in Byte zeigt.

Eingabe-/Ausgabepuffer

n/a

Länge des Eingabe-/Ausgabepuffers

n/a

Statusblock

Reserviert für die Systemverwendung.

Bemerkungen

Rufen Sie zum Ausführen dieses Vorgangs FltFsControlFile- oder ZwFsControlFile- mit den folgenden Parametern auf.

Parameter	Beschreibung
Instanz-	[in] Nur für FltFsControlFile. Ein undurchsichtiger Instanzzeiger 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, die das Ziel dieser Anforderung ist. Dieser Parameter ist erforderlich und darf nicht NULL sein.
IoStatusBlock-	[out] Nur für ZwFsControlFile. Zeigen Sie auf eine IO_STATUS_BLOCK Struktur, in der der endgültige Status der Anforderung zurückgegeben wird.
FsControlCode-	[in] Auf FSCTL_QUERY_FILE_REGIONSfestgelegt.
InputBuffer-	[in/optional] Zeigen Sie auf eine FILE_REGION_INPUT Struktur, die die abzufragenden Dateibereiche angibt.
InputBufferLength-	[in] Größe des Puffers, auf den InputBuffer in Bytes .
OutputBuffer-	[out] Zeigen Sie auf eine FILE_REGION_OUTPUT Struktur, in der die Ergebnisse der Abfrage zurückgegeben werden.
OutputBufferLength-	[out] Größe des Puffers, der OutputBuffer in Byte zeigt.
LengthReturned	[out] Zeiger auf eine vom Aufrufer zugewiesene Variable, die die Größe in Byte der im Puffer zurückgegebenen Informationen bei OutputBuffer-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 sie auf die in OutputBufferzurückgegebenen Informationen zugreifen.