共用方式為


TXFS_MODIFY_RM結構(winioctl.h)

[Microsoft 強烈建議開發者採用替代方式來滿足您的應用程式需求。 TxF 所開發的許多情境,可以透過更簡單且更容易取得的技術來實現。 此外,TxF 可能不會在未來的 Microsoft Windows 版本中提供。 欲了解更多資訊及交易型 NTFS 的替代方案,請參閱 「交易型 NTFS 的替代方案」。]

包含修改次要資源管理員記錄參數和記錄模式時所需的資訊。

語法

typedef struct _TXFS_MODIFY_RM {
  DWORD     Flags;
  DWORD     LogContainerCountMax;
  DWORD     LogContainerCountMin;
  DWORD     LogContainerCount;
  DWORD     LogGrowthIncrement;
  DWORD     LogAutoShrinkPercentage;
  DWORDLONG Reserved;
  WORD      LoggingMode;
} TXFS_MODIFY_RM, *PTXFS_MODIFY_RM;

Members

Flags

要設定的對數參數。

此成員可為以下一項或多項數值。

價值觀 Meaning
TXFS_RM_FLAG_LOGGING_MODE
0x00000001
若設定此旗標,則該結構中的 LoggingMode 成員正在使用。 若旗標未被設定, LoggingMode 成員將被忽略。
TXFS_RM_FLAG_RENAME_RM
0x00000002
若設定此旗標,RM 會被指示重新命名(建立新的 GUID)。
TXFS_RM_FLAG_LOG_CONTAINER_COUNT_MAX
0x00000004
若設定此旗標,則表示使用 LogContainerCountMax 成員。 若未設定旗標, LogContainerCountMax 成員將被忽略。 這面旗幟與 TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MIN互斥。
TXFS_RM_FLAG_LOG_CONTAINER_COUNT_MIN
0x00000008
若此旗標被設定,則使用 LogContainerCountMin 成員。 若未設定旗標, LogContainerCountMin 成員將被忽略。 這面旗幟與 TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MAX互斥。
TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_NUM_CONTAINERS
0x00000010
如果設定了這個旗標,就會使用 LogGrowthIncrement 成員。 若未設定旗標, LogGrowthIncrement 成員將被忽略。 此旗標表示日誌應隨 LogGrowthIncrement 成員中指定的容器數量成長。 這面旗幟與 TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_PERCENT是互斥的。
TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_PERCENT
0x00000020
如果設定了這個旗標,就會使用 LogGrowthIncrement 成員。 若未設定旗標, LogGrowthIncrement 成員將被忽略。 此旗標表示日誌應依 LogGrowthIncrement 成員中指定的日誌大小百分比成長。 這面旗幟與 TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_NUM_CONTAINERS是互斥的。
TXFS_RM_FLAG_LOG_AUTO_SHRINK_PERCENTAGE
0x00000040
如果設定了這個旗標,表示正在使用 LogAutoShrinkPercent 成員。 如果旗標未被設定, LogAutoShrinkPercentage 會被忽略。
TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MAX
0x00000080
若設定此旗標,RM 會被指示允許其對數無限增長。 這面旗幟與 TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MIN互斥。
TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MIN
0x00000100
若此旗標被設定,RM 會被指示允許其日誌將原木縮小為僅兩個容器。 這面旗幟與 TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MAX互斥。
TXFS_RM_FLAG_GROW_LOG
0x00000400
若設定此旗標,日誌會立即將其大小增加至 LogContainerCount 中指定的大小。 若未設定該旗標, LogContainerCount 將被忽略。
TXFS_RM_FLAG_SHRINK_LOG
0x00000800
若設定此旗標,日誌會立即將其大小縮減至 LogContainerCount 指定大小。 若設定此旗標與 TXFS_RM_FLAG_ENFORCE_MINIMUM_SIZE ,日誌會被指示縮減至最小允許大小, LogContainerCount 則被忽略。
TXFS_RM_FLAG_ENFORCE_MINIMUM_SIZE
0x00001000
若設定此旗標與 TXFS_RM_FLAG_SHRINK_LOG ,日誌會被指示縮減至最小允許大小, LogContainerCount 則被忽略。 如果這個旗標被設定, TXFS_RM_FLAG_SHRINK_LOG 也必須被設定。
TXFS_RM_FLAG_PRESERVE_CHANGES
0x00002000
若設定此旗標,日誌會被指示保留磁碟上的變更。 若未設定此旗標,任何變更皆為暫時性(即直到 RM 關閉並重新啟動為止)。
TXFS_RM_FLAG_RESET_RM_AT_NEXT_START
0x00004000
此旗標僅適用於預設的 RM,不適用於次要 RM。 若此旗標被設定,RM 下次啟動時會被指示自行重置。 日誌及相關的元資料會被刪除。
TXFS_RM_FLAG_DO_NOT_RESET_RM_AT_NEXT_START
0x00008000
此旗標僅適用於預設的 RM,不適用於次要 RM。 若此標誌被設定,先前對 FSCTL_TXFS_MODIFY_RM 的呼叫會因 TXFS_RM_FLAG_RESET_RM_AT_NEXT_START 標誌設定而被取消。
TXFS_RM_FLAG_PREFER_CONSISTENCY
0x00010000
表示 RM 優先考量交易 一致性 而非系統 可用性。 此旗標與 TXFS_RM_FLAG_PREFER_AVAILABILITY 互斥,且系統磁碟區的預設 RM 不支援。
TXFS_RM_FLAG_PREFER_AVAILABILITY
0x00020000
表示 RM 優先考量系統 可用性 而非交易 一致性。 此旗標與 TXFS_RM_FLAG_PREFER_CONSISTENCY 互斥,且由系統磁碟區的預設 RM 強制啟用。

LogContainerCountMax

原木的最大尺寸,裝在容器裡。

LogContainerCountMin

原木最小尺寸,裝在容器裡。

LogContainerCount

木頭的實際大小,裝在容器裡。

LogGrowthIncrement

容器數量或應該加入原木的空間百分比。

LogAutoShrinkPercentage

原木空間的百分比。 當使用 TXFS_RM_FLAG_LOG_AUTO_SHRINK_PERCENTAGE 旗標時,該成員會指示日誌自動縮減,因此任何時候空閒的日誌百分比不超過 LogAutoShrinkT%。

Reserved

已保留。

LoggingMode

目前的日誌模式。

價值觀 Meaning
TXFS_LOGGING_MODE_SIMPLE
1
使用簡單的記錄。
TXFS_LOGGING_MODE_FULL
2
使用完整記錄

需求

Requirement 價值觀
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2008 [僅限傳統型應用程式]
Header winioctl.h (包括 Windows.h)

另請參閱

FSCTL_TXFS_MODIFY_RM