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