次の方法で共有

TXFS_MODIFY_RM構造体 (winioctl.h)

  • [アーティクル]

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

メンバー

Flags

設定するログ パラメーター。

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

値 意味
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
 このフラグを設定すると、 LogAutoShrinkPercentage メンバーが使用されます。 フラグが設定されていない場合、 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 はログが 2 つのコンテナーのみにログを圧縮できるように指示されます。 このフラグは、 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
 このフラグは、セカンダリ VM ではなく、既定の VM でのみ有効です。 このフラグが設定されている場合、RM は次回開始されるときに自身をリセットするように指示されます。 ログと関連するメタデータが削除されます。
TXFS_RM_FLAG_DO_NOT_RESET_RM_AT_NEXT_START
0x00008000
 このフラグは、セカンダリ VM ではなく、既定の VM でのみ有効です。 このフラグが設定されている場合、 TXFS_RM_FLAG_RESET_RM_AT_NEXT_START フラグを設定すると、 FSCTL_TXFS_MODIFY_RM への以前の呼び出しが取り消されます。
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 フラグが使用されている場合に使用され、ログ自体を自動的に圧縮するようにログに指示するため、 ログの LogAutoShrinkPercentage を指定した時点で空き容量を超える必要はありません。

Reserved

予約済み。

LoggingMode

現在のログ モード。

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

要件

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

こちらもご覧ください

FSCTL_TXFS_MODIFY_RM