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