FileMax

[アーティクル]
07/17/2024

ETW によって作成されるログファイルのインスタンスの最大数。この要素は、ファイルモードの自動ロガー構成にのみ適用されます。 FileMax の詳細については、「自動ロガーセッションの構成と開始」を参照してください。

要素の階層

< WindowsPerformanceRecorder>
- < プロファイル>
  - < SystemCollector>
    - < FileMax>
  - < EventCollector>
    - < FileMax>
  - < HeapEventCollector>
    - < FileMax>
  - < HypervisorEventCollector>
    - < FileMax>
  - < Profile>
    - < コレクター>
      - < SystemCollectorId>
        
        < FileMax>
      - < EventCollectorId>
        
        < FileMax>
      - < HeapEventCollectorId>
        
        < FileMax>
      - < HypervisorEventCollectorId>
        
        < FileMax>

構文

<FileMax Operation               = "Set" | "Add" | “Remove”
         Value                   = unsignedLong>
</FileMax>

属性および要素

属性

属性	説明	データ型	必須	Default
操作	FileMax を設定するか追加するかを示します。	この属性は、次のいずれかの値になります。オン追加削除	いいえ	オン
Value	ETW によって作成されるログファイルのインスタンスの最大数を示します。最大値は 16 です。	unsignedLong	はい

子要素

なし。

親要素

要素	説明
EventCollector	イベントコレクターを表します。
EventCollectorId	イベントコレクター識別子を表します。
HeapEventCollector	ヒープイベントコレクターを表します。
HeapEventCollectorId	ヒープイベントコレクター識別子を表します。
SystemCollector	システムコレクターを表します。
SystemCollectorId	システムコレクター識別子を表します。
HypervisorCollector	ハイパーバイザーコレクターを表します。
HypervisorCollectorId	ハイパーバイザーコレクター識別子を表します。

解説

この要素は、ファイルモードの記録にのみ使用されます。

例

次の例は、イベントコレクター定義でこの要素がどのように使用されるかを示しています。

この EventCollector を使用して自動ロガーを設定すると、ETW によって、ブートごとに異なるファイル名 (sessionname.etl.0001> など<) のトレースファイルが作成されます。ファイルの最大インスタンス数は 5 です。

<EventCollector Id="EventCollector_MultimediaEx" Name="WPDiet MultimediaEx">
  <BufferSize Value="128"/>
  <Buffers Value="40"/>
  <MaximumFileSize Value="100" FileMode="Circular"/>
  <FileMax Value="5"/>
</EventCollector>

HypervisorEventCollector