FILE_STORAGE_INFO構造体 (winbase.h)

ファイルのディレクトリ情報が含まれます。 FileStorageInfo が FileInformationClass パラメーターで渡されると、この構造体は GetFileInformationByHandleEx 関数から返されます。

構文

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;

メンバー

LogicalBytesPerSector

物理ストレージによって報告されるセクターあたりの論理バイト数。 これは、キャッシュされていない I/O がサポートされる最小サイズです。

PhysicalBytesPerSectorForAtomicity

アトミック書き込みのセクターあたりのバイト数。 これより小さい書き込みでは、ブロック全体をアトミックに書き込む前に読み取りが必要になる場合があります。

PhysicalBytesPerSectorForPerformance

書き込みに最適なパフォーマンスを得るためのセクターあたりのバイト数。

FileSystemEffectivePhysicalBytesPerSectorForAtomicity

これは、ファイル システムによってアトミックに使用されるブロックのサイズです。 これは、物理メディアの最適なサイズと、既存のコードと構造の適応が容易なサイズとの間のトレードオフである可能性があります。

Flags

このメンバーには、ストレージの配置に関する情報を指定するフラグの組み合わせを含めることができます。

ByteOffsetForSectorAlignment

最初の論理セクターが配置される最初の物理セクター内の論理セクター オフセット (バイト単位)。 この値が STORAGE_INFO_OFFSET_UNKNOWN (0xffffffff ) に設定されている場合、このフィールドを計算するための情報が不足していました。

ByteOffsetForPartitionAlignment

ストレージ デバイスの物理セクター境界にパーティションを配置するために使用されるオフセット (バイト単位)。 この値が STORAGE_INFO_OFFSET_UNKNOWN (0xffffffff ) に設定されている場合、このフィールドを計算するための情報が不足していました。

解説

異なるプロパティ (ミラー化、スパン、ストライプ、RAID 構成など) を持つストレージ デバイスの上にボリュームが構築されている場合、返されるサイズは、基になる任意のストレージ デバイスの最大サイズです。

要件

関連項目

FILE_INFO_BY_HANDLE_CLASS

ファイル管理の構造体

GetFileInformationByHandleEx