Share via


撰寫錄製設定檔

您可以在副檔名為 .wprp 的 XML 檔案中撰寫 Windows Performance Recorder (WPR) 錄製設定檔。 錄製設定檔包含啟用特定案例之效能錄製的所有必要資訊。 此資料包括 Windows 事件追蹤 (ETW) 會話、提供者和關鍵字的相關資訊。 每個 .wprp 檔案都包含至少一個設定檔定義,以合併一組特定的 ETW 會話和提供者。 設定檔定義也包含啟動和控制效能錄製的會話和提供者屬性。

WPR 設定檔支援下列 ETW 功能:

  • 循序檔案和迴圈記憶體記錄模式。

  • 每個會話的使用者指定緩衝區數目和緩衝區大小。

  • ETW 系統記錄器會話與 NT 核心記錄器一起。 這項合併包括指定關鍵字、堆疊和記憶體集區標籤的能力。

  • 指定提供者名稱或 GUID、關鍵字、堆疊、詳細層級和非分頁式記憶體的事件會話。

  • 擷取只在啟動或儲存作業期間擷取狀態的狀態提供者。

.wprp 檔案必須包含以特定順序列出的特定定義。 下列主題描述如何依該順序撰寫定義。

在 Visual Studio 中撰寫 .wprp 檔案

您可以使用 Visual Studio 來使用 WPR 架構檔案 WPRControlProfiles.xsd 來撰寫錄製設定檔,該檔案位於 WPT 安裝資料夾中:

  1. 在 Visual Studio 中開啟 .wprp 檔案。

  2. 在主功能表中,選擇 [XML],然後選擇 [ 架構...

  3. 在出現的 [XML 架構] 對話方塊中,選擇 [ 新增...]

  4. 選擇 WPRControlProfiles.xsd 架構。 根據預設,此檔案位於 WPT 安裝目錄中:

    • C:\Program Files (x86)\Windows Kits\8.1\Windows Performance Toolkit

選取架構之後,您可以使用內容相關的 IntelliSense 來撰寫 .wprp 檔案。

本節內容

1.收集器定義

如何定義設定檔的收集器。

2.系統和事件提供者定義

如何定義設定檔的提供者。

3.設定檔定義

如何定義設定檔。

Strict 提供者

如何使用 Strict 屬性。

繼承

描述撰寫錄製設定檔中的繼承。

錄製設定檔

撰寫自訂錄製設定檔

新增或移除自訂錄製設定檔