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 つ以上を指定できます。
| 値 | 意味 |
|---|---|
|
このフラグが設定されている場合、この構造体の LoggingMode メンバーが使用されます。 フラグが設定されていない場合、 LoggingMode メンバーは無視されます。 |
|
このフラグが設定されている場合、RM は自身の名前を変更するように指示されます (新しい GUID を作成します)。 |
|
このフラグを設定すると、 LogContainerCountMax メンバーが使用されます。 フラグが設定されていない場合、 LogContainerCountMax メンバーは無視されます。 このフラグは、 TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MINと相互に排他的です。 |
|
このフラグを設定すると、 LogContainerCountMin メンバーが使用されます。 フラグが設定されていない場合、 LogContainerCountMin メンバーは無視されます。 このフラグは、 TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MAXと相互に排他的です。 |
|
このフラグを設定すると、 LogGrowthIncrement メンバーが使用されます。 フラグが設定されていない場合、 LogGrowthIncrement メンバーは無視されます。 このフラグは、 LogGrowthIncrement メンバーで指定されたコンテナーの数だけログを拡大する必要があることを示します。 このフラグは、 TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_PERCENTと相互に排他的です。 |
|
このフラグを設定すると、 LogGrowthIncrement メンバーが使用されます。 フラグが設定されていない場合、 LogGrowthIncrement メンバーは無視されます。 このフラグは、 LogGrowthIncrement メンバーで指定されたログ サイズの割合でログを拡大する必要があることを示します。 このフラグは、 TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_NUM_CONTAINERSと相互に排他的です。 |
|
このフラグを設定すると、 LogAutoShrinkPercentage メンバーが使用されます。 フラグが設定されていない場合、 LogAutoShrinkPercentage は無視されます。 |
|
このフラグが設定されている場合、RM は、そのログが境界なしで拡張されるように指示されます。 このフラグは、 TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MINと相互に排他的です。 |
|
このフラグが設定されている場合、RM はログが 2 つのコンテナーのみにログを圧縮できるように指示されます。 このフラグは、 TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MAXと相互に排他的です。 |
|
このフラグが設定されている場合、 LogContainerCount で指定されたサイズにサイズをすぐに増やすようにログに指示されます。 フラグが設定されていない場合、 LogContainerCount は無視されます。 |
|
このフラグが設定されている場合、 LogContainerCount で指定されたサイズにサイズを直ちに縮小するようにログに指示されます。 このフラグと TXFS_RM_FLAG_ENFORCE_MINIMUM_SIZE が設定されている場合、ログは最小許容サイズに縮小するように指示され、 LogContainerCount は無視されます。 |
|
このフラグと TXFS_RM_FLAG_SHRINK_LOG が設定されている場合、ログは最小許容サイズに縮小するように指示され、 LogContainerCount は無視されます。 このフラグを設定する場合は、 TXFS_RM_FLAG_SHRINK_LOG を設定する必要があります。 |
|
このフラグが設定されている場合は、ディスク上の変更を保持するようにログに指示されます。 このフラグが設定されていない場合、加えられた変更は一時的なものになります (つまり、RM がシャットダウンされて再起動されるまで)。 |
|
このフラグは、セカンダリ VM ではなく、既定の VM でのみ有効です。 このフラグが設定されている場合、RM は次回開始されるときに自身をリセットするように指示されます。 ログと関連するメタデータが削除されます。 |
|
このフラグは、セカンダリ VM ではなく、既定の VM でのみ有効です。 このフラグが設定されている場合、 TXFS_RM_FLAG_RESET_RM_AT_NEXT_START フラグを設定すると、 FSCTL_TXFS_MODIFY_RM への以前の呼び出しが取り消されます。 |
|
RM がシステムの可用性よりもトランザクションの一貫性を優先することを示します。 このフラグは 、TXFS_RM_FLAG_PREFER_AVAILABILITY と相互に排他的であり、システム・ボリューム上のデフォルト RM ではサポートされていません。 |
|
RM がトランザクションの整合性よりもシステム の可用性 を優先することを示 します。 このフラグは 、TXFS_RM_FLAG_PREFER_CONSISTENCY と相互に排他的であり、システム・ボリューム上のデフォルト RM によって強制されます。 |
LogContainerCountMax
コンテナー内のログの最大サイズ。
LogContainerCountMin
コンテナー内のログの最小サイズ。
LogContainerCount
コンテナー内のログの実際のサイズ。
LogGrowthIncrement
ログに追加するコンテナーの数または領域の割合。
LogAutoShrinkPercentage
空き領域を保持するログ領域の割合。 このメンバーは 、TXFS_RM_FLAG_LOG_AUTO_SHRINK_PERCENTAGE フラグが使用されている場合に使用され、ログ自体を自動的に圧縮するようにログに指示するため、 ログの LogAutoShrinkPercentage を指定した時点で空き容量を超える必要はありません。
Reserved
予約済み。
LoggingMode
現在のログ モード。
| 値 | 意味 |
|---|---|
|
単純なログ記録が使用されます。 |
|
完全なログ記録が使用されます |
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| Header | winioctl.h (Windows.h を含む) |