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;
Angehörige
FileOffset
Eine 64-Bit-ganzzahl mit Vorzeichen, die den Dateioffset (in Byte) des Anfangs eines Bytebereichs in einer Datei enthält.
Length
Eine 64-Bit-Ganzzahl mit Vorzeichen, die die Größe des Bereichs in Byte enthält.
DesiredUsage
Eine 32-Bit-ganzzahl ohne Vorzeichen, die Verwendungsparameter 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 (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 über die 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_REGIONangegeben wird, gibt ein anderer Wert STATUS_INVALID_PARAMETER zurück. |
Bemerkungen
Weitere Informationen finden Sie unter FSCTL_QUERY_FILE_REGIONS.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 8 |
| Header- | ntifs.h |