CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT結構 (ntifs.h)
CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT 結構包含額外的 create 參數 (ECP) 內容,可傳送至叢集共用磁碟區 (CSV) 檔案系統,以設定如何處理 IO 抵達此開啟的屬性。
語法
typedef struct _CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT {
SIZE_T Size;
ULONG PauseTimeoutInSeconds;
ULONG Flags;
} CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT, *PCSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT;
成員
Size
這個結構的大小,以位元組為單位。
PauseTimeoutInSeconds
當 CSV 磁碟區暫停時,允許 CSVFS 在此檔案物件上保留處於擱置狀態的 IO 秒數。 一旦時間到期,CSV 就會完成此檔案對象上發出且狀態為STATUS_CSV_IO_PAUSE_TIMEOUT的所有 IO。 這個成員可以是下列其中一個值。
價值 | 意義 |
---|---|
0xFFFFFFFF | 表示沒有逾時,而且會要求預設行為。 |
0 | CSV 不會暫停 IO,而且會立即完成 IO。 |
任何其他值 | CSV 會將所有其他值四捨五入為 10 秒的倍數,並使用此值作為逾時。 支援的最大逾時值為30分鐘。 如果所提供的值大於 30 分鐘,CSV 會以無訊息方式將值設定為最大值。 |
Flags
set 屬性旗標。 這個成員可以是下列旗標的位 OR。
旗 | 意義 |
---|---|
CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT_FLAGS_VALID_ONLY_IF_CSV_COORDINATOR | 告知 CSVFS 此檔案開啟應該只在協調節點上有效。 如果開啟是 CSVFS,而節點不是協調節點,則開啟將會失敗。 如果檔案已開啟且協調節點已移動,則開啟的檔案將會失效。 只有在直接在 CSVFS 上開啟檔案時,才會使用此旗標,並在透過 SMB 開啟檔案時忽略。 |
較低的16位 Flags 適用於會導致建立失敗且 CSV 無法辨識這些旗標的旗標STATUS_INVALID_PARAMETER。 如果 CSVFS 不知道如何處理旗標,則會以無訊息方式忽略上方 16 位。
言論
呼叫 ECP 相關支援例程時,系統定義的GUID_ECP_CSV_SET_HANDLE_PROPERTIES值會與這個 ECP 內容結構搭配使用,例如 FltAllocateExtraCreateParameter 和 FsRtlRemoveExtraCreateParameter。
如需詳細資訊,請參閱 額外建立參數 簡介。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 8 |
標頭 | ntifs.h |