共用方式為


TXFS_QUERY_RM_INFORMATION結構(winioctl.h)

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

包含資源管理員 (RM) 的相關信息。

語法

typedef struct _TXFS_QUERY_RM_INFORMATION {
  DWORD         BytesRequired;
  DWORDLONG     TailLsn;
  DWORDLONG     CurrentLsn;
  DWORDLONG     ArchiveTailLsn;
  DWORDLONG     LogContainerSize;
  LARGE_INTEGER HighestVirtualClock;
  DWORD         LogContainerCount;
  DWORD         LogContainerCountMax;
  DWORD         LogContainerCountMin;
  DWORD         LogGrowthIncrement;
  DWORD         LogAutoShrinkPercentage;
  DWORD         Flags;
  WORD          LoggingMode;
  WORD          Reserved;
  DWORD         RmState;
  DWORDLONG     LogCapacity;
  DWORDLONG     LogFree;
  DWORDLONG     TopsSize;
  DWORDLONG     TopsUsed;
  DWORDLONG     TransactionCount;
  DWORDLONG     OnePCCount;
  DWORDLONG     TwoPCCount;
  DWORDLONG     NumberLogFileFull;
  DWORDLONG     OldestTransactionAge;
  GUID          RMName;
  DWORD         TmLogPathOffset;
} TXFS_QUERY_RM_INFORMATION, *PTXFS_QUERY_RM_INFORMATION;

Members

BytesRequired

FSCTL_TXFS_QUERY_RM_INFORMATION 回傳 ERROR_BUFFER_TOO_SMALL,該成員指定回傳所需資訊所需的最小位元組數,包括 NULL 終止字元。

TailLsn

目前RM使用的最古老的日誌序號(LSN)。

CurrentLsn

陸軍陸戰隊最近一次在日誌中使用的LSN。

ArchiveTailLsn

日誌的歸檔尾部的 LSN。

LogContainerSize

日誌容器的實際大小,以位元組為單位。

HighestVirtualClock

日誌記錄所關聯的最高時間戳記。

LogContainerCount

原木容器的數量。

LogContainerCountMax

最大數量的原木容器。

LogContainerCountMin

記錄中允許的容器數量。

LogGrowthIncrement

原木會生長的量,可以是容器數量或原木尺寸的百分比;所使用的成長型態由 Flags 成員中設定的旗標指定。

LogAutoShrinkPercentage

若自動縮減政策啟用,該成員會指定日誌中最大允許的空閒空間。 如果該成員為零,則自動縮小策略未生效。

Flags

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

價值觀 Meaning
TXFS_RM_FLAG_LOG_CONTAINER_COUNT_MIN
0x00000008
如果標記已設定,RM 的日誌會盡可能縮小。 這面旗幟與 TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MAX互斥。
TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_NUM_CONTAINERS
0x00000010
表示 LogGrowthIncrement 中的值類型。 如果設定了這個旗標, LogGrowthIncrement 就是多個容器。 這面旗幟與 TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_PERCENT是互斥的。
TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_PERCENT
0x00000020
表示 LogGrowthIncrement 中的值類型。 若此標記被設定, LogGrowthIncrement 即為百分比。 這面旗幟與 TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_NUM_CONTAINERS是互斥的。
TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MAX
0x00000080
表示 RM 的對數可以無限成長。 這面旗幟與 TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MIN互斥。
TXFS_RM_FLAG_RESET_RM_AT_NEXT_START
0x00004000
顯示 RM 重置旗標的當前狀態。 如果設定了這個,RM 下一次啟動時會自動重置。 此旗標僅適用於預設的 RM,不適用於次要 RM。 這面旗幟與 TXFS_RM_FLAG_DO_NOT_RESET_RM_AT_NEXT_START是互斥的。
TXFS_RM_FLAG_DO_NOT_RESET_RM_AT_NEXT_START
0x00008000
顯示 RM 重置旗標的當前狀態。 如果設定了這個,RM 下次啟動時就不會自動重置。 此旗標僅適用於預設的 RM,不適用於次要 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 強制啟用。

LoggingMode

目前的日誌模式。

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

Reserved

已保留。

RmState

RM的現狀。 有效的數值如下。

價值觀 Meaning
TXFS_RM_STATE_NOT_STARTED
0
RM尚未開始。
TXFS_RM_STATE_STARTING
1
RM要開始了。
TXFS_RM_STATE_ACTIVE
2
該 RM 已啟用並準備接受交易。
TXFS_RM_STATE_SHUTTING_DOWN
3
皇家住宅區正在關閉。

LogCapacity

日誌的總容量,以位元組為單位。

LogFree

日誌中空閒的位元組數。

TopsSize

$Tops檔案大小,以位元組為單位。

TopsUsed

正在使用的$Tops檔案數量,以位元組為單位。

TransactionCount

查詢時的活躍交易數量。

OnePCCount

該 RM 上發生的單階段提交操作數量。

TwoPCCount

此 RM 上已發生的兩階段提交操作數量。

NumberLogFileFull

這位RM的日誌已經滿了的次數。

OldestTransactionAge

最早的有效交易長度,以毫秒為單位。

RMName

指示該RM名稱的 GUID

TmLogPathOffset

從此結構起始點到包含 TM 日誌路徑的 NULL 終止 Unicode 字串的偏移量。

需求

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

另請參閱

FSCTL_TXFS_QUERY_RM_INFORMATION

TxF 結構