CLFS_MGMT_POLICY構造体 (wdm.h)
CLFS_MGMT_POLICY構造には、CLFS ログを管理するためのポリシーの説明が保持されます。
構文
typedef struct _CLFS_MGMT_POLICY {
ULONG Version;
ULONG LengthInBytes;
ULONG PolicyFlags;
CLFS_MGMT_POLICY_TYPE PolicyType;
union {
struct {
ULONG Containers;
} MaximumSize;
struct {
ULONG Containers;
} MinimumSize;
struct {
ULONG SizeInBytes;
} NewContainerSize;
struct {
ULONG AbsoluteGrowthInContainers;
ULONG RelativeGrowthPercentage;
} GrowthRate;
struct {
ULONG MinimumAvailablePercentage;
ULONG MinimumAvailableContainers;
} LogTail;
struct {
ULONG Percentage;
} AutoShrink;
struct {
ULONG Enabled;
} AutoGrow;
struct {
USHORT PrefixLengthInBytes;
WCHAR PrefixString[1];
} NewContainerPrefix;
struct {
ULONGLONG NextContainerSuffix;
} NewContainerSuffix;
struct {
USHORT ExtensionLengthInBytes;
WCHAR ExtensionString[1];
} NewContainerExtension;
} PolicyParameters;
} CLFS_MGMT_POLICY, *PCLFS_MGMT_POLICY;
メンバー
Version
CLFS_MGMT_POLICY構造体のバージョン。 これを [CLFS_MGMT_POLICY_VERSION] に設定します。
LengthInBytes
CLFS_MGMT_POLICY構造体の長さ。
PolicyFlags
CLFS_MGMT_POLICY構造体のこのインスタンスに適用されるフラグ。 このリリースに実装されているフラグは LOG_POLICY_OVERWRITEのみです。これは、ポリシーがインストールされるときに、同じ種類のポリシーが既に存在する場合に置き換えることを示します。
PolicyType
CLFS_MGMT_POLICY構造体のこのインスタンスの型を提供するCLFS_MGMT_POLICY_TYPE列挙の値。
PolicyParameters
CLFS_MGMT_POLICY構造体のこのインスタンスに関する詳細情報を提供する共用体。
PolicyParameters.MaximumSize
PolicyType が ClfsMgmtPolicyMaximumSize であるポリシーに関する詳細情報を提供する構造体。
PolicyParameters.MaximumSize.Containers
ログで使用されるコンテナーの最大数。
PolicyParameters.MinimumSize
PolicyType が ClfsMgmtPolicyMinimumSize であるポリシーに関する詳細情報を提供する構造体。
PolicyParameters.MinimumSize.Containers
ログで使用されるコンテナーの最小数。
PolicyParameters.NewContainerSize
PolicyType が ClfsMgmtPolicyNewContainerSize であるポリシーに関する詳細情報を提供する構造体。
PolicyParameters.NewContainerSize.SizeInBytes
ログの各コンテナーのサイズ。
PolicyParameters.GrowthRate
PolicyType が ClfsMgmtPolicyGrowthRate であるポリシーに関する詳細情報を提供する構造体。
PolicyParameters.GrowthRate.AbsoluteGrowthInContainers
ログのサイズを大きくするときに追加する必要があるコンテナーの数。 RelativeGrowthPercentage メンバーが 0 以外の場合、AbsoluteGrowthInContainers は 0 である必要があります。
PolicyParameters.GrowthRate.RelativeGrowthPercentage
ログが大きくなると、ログのサイズが増加する割合 。0 から 100 までの数値で表されます。 たとえば、ログが 32 個のコンテナーで構成され、 RelativeGrowthPercentage が 10 個の場合、ログを拡張する必要があるときに、3 つ (32 * 10%、最も近い整数に切り捨てられた) コンテナーが増加します。 AbsoluteGrowthInContainers メンバーが 0 以外の場合、RelativeGrowthPercentage は 0 である必要があります。
PolicyParameters.LogTail
PolicyType が ClfsMgmtPolicyLogTail であるポリシーに関する詳細情報を提供する構造体。
PolicyParameters.LogTail.MinimumAvailablePercentage
CLFS 管理によって、ログ末尾の移動がクライアントに通知されると、ログの 少なくとも MinimumAvailablePercentage % が解放された LSN に末尾を移動するように指定されます。 MinimumAvailableContainers メンバーが 0 以外の場合、MinimumAvailablePercentage は 0 である必要があります。
PolicyParameters.LogTail.MinimumAvailableContainers
CLFS 管理によって、ログ末尾の移動がクライアントに通知されると、少なくとも MinimumAvailableContainers コンテナーが解放された LSN に末尾を移動するように指定されます。 MinimumAvailablePercentage メンバーが 0 以外の場合、MinimumAvailableContainers は 0 である必要があります。
PolicyParameters.AutoShrink
PolicyType が ClfsMgmtPolicyAutoShrink であるポリシーに関する詳細情報を提供する構造体。
PolicyParameters.AutoShrink.Percentage
ログ内の空き領域の割合が [パーセンテージ] に達すると、ログは縮小されます。 パーセンテージは 0 ~ 100 の数値で表されるため、値 25 は 25% を意味します。
PolicyParameters.AutoGrow
PolicyType が ClfsMgmtPolicyAutoGrow であるポリシーに関する詳細情報を提供する構造体。
PolicyParameters.AutoGrow.Enabled
ログの自動拡張を有効にするかどうかを決定する数値。 0 以外の値を指定すると、自動拡張が有効になります。
PolicyParameters.NewContainerPrefix
PolicyType が ClfsMgmtPolicyNewContainerPrefix であるポリシーに関する詳細情報を提供する構造体。
PolicyParameters.NewContainerPrefix.PrefixLengthInBytes
PrefixString メンバーの長さ (バイト単位)。
PolicyParameters.NewContainerPrefix.PrefixString[1]
ログのコンテナーが存在するディレクトリへの完全なパスと、ログ内の各コンテナーのファイル名の一部として使用されるプレフィックスを含むワイド文字列。
PolicyParameters.NewContainerSuffix
PolicyType が ClfsMgmtPolicyNewContainerSuffix であるポリシーに関する詳細情報を提供する構造体。
PolicyParameters.NewContainerSuffix.NextContainerSuffix
ログ内の次のコンテナーのファイル名のサフィックスとして使用する番号。 ファイル名を形成するために、数値は 10 進数の文字列に変換され、プレフィックス文字列に追加されます。 番号は、後続の各コンテナーのファイル名に対してインクリメントされます。
PolicyParameters.NewContainerExtension
PolicyType が ClfsMgmtPolicyNewContainerExtension であるポリシーに関する詳細情報を提供する構造体。
PolicyParameters.NewContainerExtension.ExtensionLengthInBytes
ExtensionString メンバーの長さ (バイト単位)。
PolicyParameters.NewContainerExtension.ExtensionString[1]
ログ内の各コンテナーのファイル名の拡張子を含むワイド文字列。 コンテナー ファイル名は、[prefix][suffix][.extension] という形式を使用して作成されます。 拡張機能は省略可能です。 既定の拡張子は空の文字列です。
注釈
CLFS_MGMT_POLICY構造体の解釈方法は、構造体が保持するポリシーの種類によって異なります。
ログの管理方法を指定する ポリシー を指定できます。 各ポリシーは CLFS_MGMT_POLICY 構造体のインスタンスですが、その構造はポリシーの種類によって解釈が異なります。 CLFS では、ポリシーで指定した情報を使用して、ログの管理方法を調整します。
PolicyType が ClfsMgmtPolicyNewContainerPrefix であるCLFS_MGMT_POLICY構造体を作成するときは、PolicyParameters.NewContainerPrefix.PrefixString 文字列を保持するのに十分な領域を割り当てるようにしてください。
PolicyType 値で指定されたポリシーの種類が ClfsMgmtPolicyNewContainerSize であるポリシーは、ログにコンテナーが存在する前にのみインストールできます。 ログが存在した後で、他のポリシーを変更できます。
要件
要件 | 値 |
---|---|
Header | wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む) |