共用方式為


VDS_HINTS 結構 (vdshwprv.h)

[從 Windows 8 和 Windows Server 2012 開始,虛擬磁碟服務 COM 介面會由 Windows 記憶體管理 API 取代。

定義 LUN 或 LUN plex 的自動放大提示。

語法

typedef struct _VDS_HINTS {
  ULONGLONG ullHintMask;
  ULONGLONG ullExpectedMaximumSize;
  ULONG     ulOptimalReadSize;
  ULONG     ulOptimalReadAlignment;
  ULONG     ulOptimalWriteSize;
  ULONG     ulOptimalWriteAlignment;
  ULONG     ulMaximumDriveCount;
  ULONG     ulStripeSize;
  BOOL      bFastCrashRecoveryRequired;
  BOOL      bMostlyReads;
  BOOL      bOptimizeForSequentialReads;
  BOOL      bOptimizeForSequentialWrites;
  BOOL      bRemapEnabled;
  BOOL      bReadBackVerifyEnabled;
  BOOL      bWriteThroughCachingEnabled;
  BOOL      bHardwareChecksumEnabled;
  BOOL      bIsYankable;
  SHORT     sRebuildPriority;
} VDS_HINTS, *PVDS_HINTS;

成員

ullHintMask

LUN 提示遮罩。 這個結構的每個 BOOL 成員都有可在遮罩中設定的對應提示旗標。 如果已設定提示旗標,則會考慮對應的提示。 如果未設定提示旗標,則會忽略提示。 下表說明提示旗標。

意義
VDS_HINT_FASTCRASHRECOVERYREQUIRED
0x00000000000000001L
提供者會限制復原所需的時間。 為了支援快速復原,提供者會使用變更記錄檔來讓提供者復原 LUN,而不比較 LUN 的整個內容。
VDS_HINT_MOSTLYREADS
0x00000000000000002L
提供者會針對大部分的讀取使用模式優化 LUN,通常是使用鏡像而非同位等量等量。
VDS_HINT_OPTIMIZEFORSEQUENTIALREADS
0x00000000000000004L
提供者會針對循序讀取使用模式優化 LUN。 如果未設定此旗標,也不會設定VDS_HINT_OPTIMIZEFORSEQUENTIALWRITES,則 LUN 會針對隨機 I/O 進行優化。
VDS_HINT_OPTIMIZEFORSEQUENTIALWRITES
0x00000000000000008L
提供者會針對循序寫入使用模式優化 LUN。 如果未設定此旗標,而且未設定VDS_HINT_OPTIMIZEFORSEQUENTIALREADS,則 LUN 會針對隨機 I/O 進行優化。
VDS_HINT_READBACKVERIFYENABLED
0x00000000000000010L
提供者會使用回寫來驗證 LUN 的寫入。
VDS_HINT_REMAPENABLED
0x0000000000000020L
提供者會自動建立 LUN 範圍與磁碟驅動器範圍的對應並更新。 如果未設定此旗標,則對應會在設定之後維持固定狀態,除非採取主動式動作以避免磁碟驅動器失敗。
VDS_HINT_WRITETHROUGHCACHINGENABLED
0x00000000000000040L
提供者會在 LUN 上啟用寫入快取原則。
VDS_HINT_HARDWARECHECKSUMENABLED
0x00000000000000080L
提供者會在 LUN 上啟用硬體總和檢查碼。
VDS_HINT_ISYANKABLE
0x00000000000000100L
提供者會設定 LUN,讓參與該磁碟驅動器的磁碟驅動器可以實際移除,且系統中斷最少。 這通常是藉由確保 LUN 佔用最少的磁碟驅動器來完成。

ullExpectedMaximumSize

LUN 預期成長的大小上限,以位元組為單位。 呼叫 IVdsSubSystem::CreateLun 方法時,此值可以等於、大於或小於 ullSizeInBytes 中指定的值。 某些提供者會使用此值來保留 LUN 的空間。 無法保留空間的提供者通常會忽略此參數。

ulOptimalReadSize

LUN 的最佳讀取大小,以位元組為單位。 零表示沒有最佳的讀取大小。

ulOptimalReadAlignment

與 LUN 的第一個邏輯區塊相關的最佳讀取對齊方式。 零表示沒有最佳的讀取對齊方式。

ulOptimalWriteSize

LUN 的最佳寫入大小,以位元組為單位。 零表示沒有最佳寫入大小。

ulOptimalWriteAlignment

與 LUN 的第一個邏輯區塊相關的最佳寫入對齊方式。 零表示沒有最佳的寫入對齊方式。

ulMaximumDriveCount

要參與 LUN 的磁碟驅動器數目上限。 零表示沒有最大磁碟驅動器計數。 這個值可用來限制等量集合中的等量交錯數目。

ulStripeSize

鏡像或同位區交錯大小,以位元組為單位。 零會保留未指定的等量大小。

bFastCrashRecoveryRequired

如果此成員為TRUE,復原時間會受到限制。 在 ullHintMask 成員中設定VDS_HINT_FASTCRASHRECOVERYREQUIRED旗標,以指出對這個成員感興趣。

bMostlyReads

例如,若要優化大部分讀取的使用模式, (例如,透過鏡像而非同位等量等量分割) ,請將此成員設定為 TRUE。 否則,請將它設定為 FALSE。 在 ullHintMask 成員中設定VDS_HINT_MOSTLYREADS旗標,以指出對這個成員感興趣。

bOptimizeForSequentialReads

若要針對循序讀取使用模式進行優化,請將此成員設定為 TRUE。 否則,請將它設定為 FALSE。 將 bOptimizeForSequentialReadsbOptimizeForSequentialWrites 成員設定為 FALSE ,以針對隨機 I/O 優化。 在 ullHintMask 成員中設定VDS_HINT_OPTIMIZEFORSEQUENTIALREADS旗標,以指出此成員感興趣。

bOptimizeForSequentialWrites

若要針對循序寫入使用模式進行優化,請將 設定為這個成員為 TRUE。 否則,請將它設定為 FALSE。 將 bOptimizeForSequentialReadsbOptimizeForSequentialWrites 成員設定為 FALSE ,以針對隨機 I/O 優化。 在 ullHintMask 成員中設定VDS_HINT_OPTIMIZEFORSEQUENTIALWRITES旗標,以指出此成員感興趣。

bRemapEnabled

如果此成員為 TRUE,提供者會自動將 LUN 範圍重新對應至磁碟驅動器範圍。 如果是 FALSE,除非明確重新對應範圍以避免損毀的區塊,否則 LUN 範圍與磁碟驅動器範圍的對應會在 LUN 設定之後維持固定狀態。 在 ullHintMask 成員中設定VDS_HINT_REMAPENABLED旗標,以指出此成員感興趣。

bReadBackVerifyEnabled

如果此成員設定為 TRUE,提供者會透過回寫來驗證 LUN 的寫入。 如果設定為 FALSE,提供者不會驗證寫入。 在 ullHintMask 成員中設定VDS_HINT_READBACKVERIFYENABLED旗標,以指出此成員感興趣。

bWriteThroughCachingEnabled

如果此成員為 TRUE,提供者會在 LUN 上啟用寫入快取。 如果為 FALSE,提供者就不會啟用寫入快取。 在 ullHintMask 成員中設定VDS_HINT_WRITETHROUGHCACHINGENABLED旗標,以指出此成員感興趣。

bHardwareChecksumEnabled

如果這個成員為 TRUE,提供者會在 LUN 上啟用總和檢查碼。 在 ullHintMask 成員中設定VDS_HINT_HARDWARECHECKSUMENABLED旗標,以指出此成員感興趣。

bIsYankable

如果此成員為 TRUE,則參與 LUN 的磁碟驅動器可以實際移除,而不會對系統造成重大中斷, (當 LUN 是由少數磁碟驅動器) 的範圍所組成時,通常是如此。 如果為 FALSE,則無法移除 LUN,而不會對系統造成重大中斷。 在 ullHintMask 成員中設定VDS_HINT_ISYANKABLE旗標,以指出此成員感興趣。

sRebuildPriority

LUN 的重建優先順序。 此值的範圍可以從 0 (最低優先順序) 到最高優先順序) 15 (。

備註

IVdsSubSystem::CreateLun 方法會將這個結構當做參數傳遞,以提供建立 LUN 的提示。 它會在 IVdsLunIVdsLunPlex 介面的 ApplyHints 方法中當做參數傳遞,分別將一組新的提示套用至 LUN 或 LUN plex。 此外,它會由IVdsLunIVdsLunPlex 介面上的 QueryHints 方法傳回,分別報告目前套用至 LUN 或 LUN plex 的提示。

提示不是實作者的指示詞。 雖然實作者一般預期會盡最大努力考慮提示,但它們不一定要遵循這些提示。 實作者可以選擇替代方法,因為技術原因而無法遵循指定的提示,或遵循這些提示可能會導致設定不佳。

規格需求

需求
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
標頭 vdshwprv.h

另請參閱

IVdsLun::ApplyHints

IVdsLun::QueryHints

IVdsLunPlex::ApplyHints

IVdsLunPlex::QueryHints

IVdsSubSystem::CreateLun

VDS 結構