winbase.h) (FILE_STORAGE_INFO 结构

包含文件的目录信息。 在 FileInformationClass 参数中传递 FileStorageInfo 时,将从 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

此成员可以包含指定有关存储对齐方式信息的标志组合。

含义
STORAGE_INFO_FLAGS_ALIGNED_DEVICE
0x00000001
设置后,此标志指示存储设备的逻辑扇区与物理扇区边界保持一致。
STORAGE_INFO_FLAGS_PARTITION_ALIGNED_ON_DEVICE
0x00000002
设置后,此标志指示分区与存储设备上的物理扇区边界对齐。

ByteOffsetForSectorAlignment

第一个逻辑扇区所在的第一个物理扇区中的逻辑扇区偏移量(以字节为单位)。 如果此值设置为 STORAGE_INFO_OFFSET_UNKNOWN (0xffffffff) ,则没有足够的信息来计算此字段。

ByteOffsetForPartitionAlignment

用于将分区与存储设备上的物理扇区边界对齐的偏移量(以字节为单位)。 如果此值设置为 STORAGE_INFO_OFFSET_UNKNOWN (0xffffffff) ,则没有足够的信息来计算此字段。

注解

如果卷基于具有不同属性的存储设备 (例如镜像、跨区、条带或 RAID 配置) 则返回的大小是任何基础存储设备的最大大小。

要求

   
最低受支持的客户端 Windows 8 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2012 [桌面应用 |UWP 应用]
标头 winbase.h (包括 Windows.h)

另请参阅

FILE_INFO_BY_HANDLE_CLASS

文件管理结构

GetFileInformationByHandleEx