FILE_STORAGE_INFO-Struktur (winbase.h)

Artikel
08/27/2023

Enthält Verzeichnisinformationen für eine Datei. Diese Struktur wird von der GetFileInformationByHandleEx-Funktion zurückgegeben, wenn FileStorageInfo im FileInformationClass-Parameter übergeben wird.

Syntax

typedef struct _FILE_STORAGE_INFO {
  ULONG LogicalBytesPerSector;
  ULONG PhysicalBytesPerSectorForAtomicity;
  ULONG PhysicalBytesPerSectorForPerformance;
  ULONG FileSystemEffectivePhysicalBytesPerSectorForAtomicity;
  ULONG Flags;
  ULONG ByteOffsetForSectorAlignment;
  ULONG ByteOffsetForPartitionAlignment;
} FILE_STORAGE_INFO, *PFILE_STORAGE_INFO;

Member

LogicalBytesPerSector

Logische Bytes pro Sektor, die vom physischen Speicher gemeldet werden. Dies ist die kleinste Größe, für die nicht zwischengespeicherte E/A-Vorgänge unterstützt werden.

PhysicalBytesPerSectorForAtomicity

Bytes pro Sektor für atomare Schreibvorgänge. Schreibvorgänge, die kleiner sind, erfordern möglicherweise einen Lesevorgang, bevor der gesamte Block atomar geschrieben werden kann.

PhysicalBytesPerSectorForPerformance

Bytes pro Sektor für optimale Leistung für Schreibvorgänge.

FileSystemEffectivePhysicalBytesPerSectorForAtomicity

Dies ist die Größe des Blocks, der vom Dateisystem für die Atomarität verwendet wird. Dies kann ein Kompromiss zwischen der optimalen Größe der physischen Medien und einer sein, die einfacher ist, vorhandenen Code und Strukturen anzupassen.

Flags

Dieses Element kann Kombinationen von Flags enthalten, die Informationen zur Ausrichtung des Speichers angeben.

Wert	Bedeutung
STORAGE_INFO_FLAGS_ALIGNED_DEVICE 0x00000001	Wenn dieses Flag festgelegt ist, gibt dieses Flag an, dass die logischen Sektoren des Speichergeräts an physischen Sektorgrenzen ausgerichtet sind.
STORAGE_INFO_FLAGS_PARTITION_ALIGNED_ON_DEVICE 0x00000002	Wenn dieses Flag festgelegt ist, gibt dieses Flag an, dass die Partition an physischen Sektorengrenzen auf dem Speichergerät ausgerichtet ist.

ByteOffsetForSectorAlignment

Logischer Sektoroffset innerhalb des ersten physischen Sektors, in dem der erste logische Sektor in Bytes platziert wird. Wenn dieser Wert auf STORAGE_INFO_OFFSET_UNKNOWN (0xffffffff) festgelegt ist, gab es nicht genügend Informationen, um dieses Feld zu berechnen.

ByteOffsetForPartitionAlignment

Offset, der verwendet wird, um die Partition an einer physischen Sektorgrenze auf dem Speichergerät in Bytes auszurichten. Wenn dieser Wert auf STORAGE_INFO_OFFSET_UNKNOWN (0xffffffff) festgelegt ist, gab es nicht genügend Informationen, um dieses Feld zu berechnen.

Hinweise

Wenn ein Volume auf Speichergeräten mit unterschiedlichen Eigenschaften (z. B. einer gespiegelten, spannten, gestreiften oder RAID-Konfiguration) basiert, entsprechen die zurückgegebenen Größen der größten Größe der zugrunde liegenden Speichergeräte.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 8 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [Desktop-Apps \| UWP-Apps]
Kopfzeile	winbase.h (einschließlich Windows.h)

Weitere Informationen

FILE_INFO_BY_HANDLE_CLASS

Strukturen in der Dateiverwaltung

GetFileInformationByHandleEx

Freigeben über