CLFS_MGMT_POLICY構造体 (wdm.h)

[アーティクル]
08/08/2023

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 であるポリシーは、ログにコンテナーが存在する前にのみインストールできます。ログが存在した後で、他のポリシーを変更できます。