次の方法で共有

TXFS_QUERY_RM_INFORMATION 構造体 (winioctl.h)

  • [アーティクル]

[Microsoft では、開発者がアプリケーションのニーズを達成するために代替手段を利用することを強くお勧めします。 TxF が開発された多くのシナリオは、よりシンプルで利用しやすい手法で実現できます。 また、将来のバージョンの Microsoft Windows では TxF を使用できない場合があります。 詳細、および TxF の代替手段については、「トランザクション 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;

メンバー

BytesRequired

FSCTL_TXFS_QUERY_RM_INFORMATIONがERROR_BUFFER_TOO_SMALLを返す場合、このメンバーは、NULL 終端文字を含め、要求された情報を返すために必要な最小バイト数を指定します。

TailLsn

RM で現在使用されている最も古いログ シーケンス番号 (LSN)。

CurrentLsn

ログ内の RM によって最後に使用された LSN。

ArchiveTailLsn

ログのアーカイブ末尾の LSN。

LogContainerSize

ログ コンテナーの実際のサイズ (バイト単位)。

HighestVirtualClock

ログ レコードに関連付けられている最も高いタイムスタンプ。

LogContainerCount

ログ コンテナーの数。

LogContainerCountMax

ログ コンテナーの最大数。

LogContainerCountMin

ログで許可されるコンテナーの最小数。

LogGrowthIncrement

ログが増加する量。これは、コンテナーの数またはログ サイズの割合です。使用される拡張の種類は、 Flags メンバーに設定されているフラグによって指定されます。

LogAutoShrinkPercentage

自動圧縮ポリシーがアクティブな場合、このメンバーはログ内の空き領域の最大許容量を指定します。 このメンバーが 0 の場合、自動圧縮ポリシーはアクティブではありません。

Flags

このメンバーには、次の値の 1 つ以上を指定できます。

値 意味
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 は次回起動時にリセットされます。 このフラグは、セカンダリ VM ではなく、既定の VM でのみ有効です。 このフラグは、 TXFS_RM_FLAG_DO_NOT_RESET_RM_AT_NEXT_STARTと相互に排他的です。
TXFS_RM_FLAG_DO_NOT_RESET_RM_AT_NEXT_START
0x00008000
 RM リセット フラグの現在の状態を示します。 この設定を行うと、RM は次回開始されるときにそれ自体をリセットしません。 このフラグは、セカンダリ VM ではなく、既定の VM でのみ有効です。 このフラグは、 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

現在のログ モード。

値 意味
TXFS_LOGGING_MODE_SIMPLE
1
 単純なログ記録が使用されます。
TXFS_LOGGING_MODE_FULL
2
 完全なログ記録が使用されます

Reserved

予約済み。

RmState

RM の状態。 有効な値は次のとおりです。

値 意味
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
 RM がシャットダウンしています。

LogCapacity

ログの合計容量 (バイト単位)。

LogFree

ログの空きバイト数。

TopsSize

$Tops ファイルのサイズ (バイト単位)。

TopsUsed

使用中の$Tops ファイルの量 (バイト単位)。

TransactionCount

クエリが発行された時点のアクティブなトランザクションの数。

OnePCCount

この RM で発生した単一フェーズのコミット操作の数。

TwoPCCount

この RM で発生した 2 フェーズ・コミット操作の数。

NumberLogFileFull

この RM のログがいっぱいになった回数。

OldestTransactionAge

最も古いアクティブなトランザクションの長さ (ミリ秒単位)。

RMName

この RM の名前を示す GUID 。

TmLogPathOffset

この構造体の先頭から、TM のログへのパスを含む NULL で終わる Unicode 文字列へのオフセット。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
Header winioctl.h (Windows.h を含む)

こちらもご覧ください

FSCTL_TXFS_QUERY_RM_INFORMATION

TxF 構造体