FILE_REGION_INPUT-Struktur (ntifs.h)
FILE_REGION_INPUT ist die optionale Eingabestruktur für FSCTL_QUERY_FILE_REGIONS.
Syntax
typedef struct _FILE_REGION_INPUT {
LONGLONG FileOffset;
LONGLONG Length;
ULONG DesiredUsage;
} FILE_REGION_INPUT, *PFILE_REGION_INPUT;
Member
FileOffset
Eine 64-Bit-Ganzzahl mit Vorzeichen, die den Dateioffset in Bytes des Anfangs eines Bytebereichs in einer Datei enthält.
Length
Eine 64-Bit-Ganzzahl mit Vorzeichen, die die Größe des Bereichs in Bytes enthält.
DesiredUsage
Eine 32-Bit-Ganzzahl ohne Vorzeichen, die Nutzungsparameter für diesen Vorgang angibt. DesiredUsage kann einer der folgenden Werte sein.
| Wert | Bedeutung |
|---|---|
| FILE_REGION_USAGE_VALID_CACHED_DATA (0x00000001) | Fordert an, dass Informationen zur gültigen Datenlänge (Valid Data Length, VDL) für die angegebene Datei und den angegebenen Dateibereich im Cache zurückgegeben werden. |
| FILE_REGION_USAGE_VALID_NONCACHED_DATA (0x00000002) | Fordert an, dass Informationen zur VDL für die angegebene Datei und den angegebenen Dateibereich auf dem Datenträger zurückgegeben werden. |
| Alle anderen Werte | Wenn ein FILE_REGION_INPUT-Objekt in FSCTL_QUERY_FILE_REGION angegeben wird, gibt jeder andere Wert STATUS_INVALID_PARAMETER zurück. |
Hinweise
Weitere Informationen finden Sie unter FSCTL_QUERY_FILE_REGIONS .
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 |
| Kopfzeile | ntifs.h |