共用方式為


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