STORAGE_WRITE_CACHE_PROPERTY 结构 (winioctl.h)

  • 项目

与 IOCTL_STORAGE_QUERY_PROPERTY 控制代码一起使用，用于检索有关设备的写入缓存属性的信息。

语法

typedef struct _STORAGE_WRITE_CACHE_PROPERTY {
  DWORD              Version;
  DWORD              Size;
  WRITE_CACHE_TYPE   WriteCacheType;
  WRITE_CACHE_ENABLE WriteCacheEnabled;
  WRITE_CACHE_CHANGE WriteCacheChangeable;
  WRITE_THROUGH      WriteThroughSupported;
  BOOLEAN            FlushCacheSupported;
  BOOLEAN            UserDefinedPowerProtection;
  BOOLEAN            NVCacheEnabled;
} STORAGE_WRITE_CACHE_PROPERTY, *PSTORAGE_WRITE_CACHE_PROPERTY;

成员

Version

包含此结构的大小（以字节为单位）。 当成员添加到 结构时，此成员的值将更改。

Size

指定返回的数据的总大小（以字节为单位）。 这可能包括遵循此结构的数据。

WriteCacheType

WRITE_CACHE_TYPE 枚举中的一个值，该值指示当前写入缓存类型。

值 含义
WriteCacheTypeUnknown
0
 系统无法报告写入缓存的类型。
WriteCacheTypeNone
1
 设备没有写入缓存。
WriteCacheTypeWriteBack
2
 设备具有写回缓存。
WriteCacheTypeWriteThrough
3
 设备具有写通缓存。

WriteCacheEnabled

WRITE_CACHE_ENABLE 枚举中的一个值，该值指示是否启用写入缓存。

值 含义
WriteCacheEnableUnknown
0
 系统无法报告是启用还是禁用了设备的写入缓存。
WriteCacheDisabled
1
 设备的写入缓存已禁用。
WriteCacheEnabled
2
 设备的写入缓存已启用。

WriteCacheChangeable

WRITE_CACHE_CHANGE 枚举中的值，该值指示主机是否可以更改写入缓存特征。

值 含义
WriteCacheChangeUnknown
0
 系统无法报告设备的写入缓存更改功能。
WriteCacheNotChangeable
1
 主机软件无法更改设备写入缓存的特征
WriteCacheChangeable
2
 主机软件可以更改设备写入缓存的特征

WriteThroughSupported

WRITE_THROUGH 枚举中的值，该值指示设备是否支持写通缓存。

值 含义
WriteThroughUnknown
0
 指示没有关于设备的写通功能的信息。
WriteThroughNotSupported
1
 指示设备不支持写通操作。
WriteThroughSupported
2
 指示设备支持写通操作。

FlushCacheSupported

一个 BOOLEAN 值，该值指示设备是否允许主机软件刷新设备缓存。 如果 为 TRUE，则设备允许主机软件刷新设备缓存。 如果 为 FALSE，则主机软件无法刷新设备缓存。

UserDefinedPowerProtection

一个 BOOLEAN 值，指示用户是否可以在注册表中配置设备的电源保护特征。 如果 为 TRUE，则用户可以在注册表中配置设备的电源保护特征。 如果 为 FALSE，则用户无法在注册表中配置设备的电源保护特征。

NVCacheEnabled

一个 BOOLEAN 值，指示设备是否具有写入缓存的电池备份。 如果 为 TRUE，则设备具有写入缓存的电池备份。 如果 为 FALSE，则设备没有写入器缓存的电池备份。

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
标头 winioctl.h (包括 Windows.h)

请参阅

磁盘管理结构

IOCTL_STORAGE_QUERY_PROPERTY