PERFORMANCE_DATA 結構 (winnt.h)

包含您要求的執行緒分析和硬體計數器資料。

語法

typedef struct _PERFORMANCE_DATA {
  WORD                  Size;
  BYTE                  Version;
  BYTE                  HwCountersCount;
  DWORD                 ContextSwitchCount;
  DWORD64               WaitReasonBitMap;
  DWORD64               CycleTime;
  DWORD                 RetryCount;
  DWORD                 Reserved;
  HARDWARE_COUNTER_DATA HwCounters[MAX_HW_COUNTERS];
} PERFORMANCE_DATA, *PPERFORMANCE_DATA;

成員

Size

此結構的大小。

Version

這個結構的版本。 必須設定為 PERFORMANCE_DATA_VERSION。

HwCountersCount

HwCounters陣列中包含硬體計數器資料的陣列元素數目。 值為 3 表示陣列包含三個硬體計數器的資料，而不是元素 0 到 2 包含計數器資料。

ContextSwitchCount

啟用時間分析所發生的內容切換數目。

WaitReasonBitMap

位元遮罩，識別自上次讀取資料以來發生之內容參數的原因。 如需可能的值，請參閱 KWAIT_REASON 列舉 (列舉包含在 WDK) 的 Wdm.h 檔案中。

CycleTime

執行緒的週期時間 (排除啟用時間分析所花費的時間中斷) 。

RetryCount

讀取作業讀取資料的次數，以確保資料的快照集一致。

Reserved

保留的。 設定為零。

HwCounters[MAX_HW_COUNTERS]

包含計數器值的 HARDWARE_COUNTER_DATA 結構的陣列。 包含計數器資料的陣列元素會直接與您呼叫EnableThreadProfiling函式時所指定的HardwareCounters位元遮罩中所設定的位有關。 例如，如果您在 HardwareCounters 位元遮罩中設定位 3，HwCounters[3] 將會包含該計數器的計數器資料。

備註

您必須先初始化 Size 和 Version 成員，才能呼叫 ReadThreadProfilingData 函式來讀取分析資料。

此結構中包含的設定檔資料取決於您呼叫 ReadThreadProfilingData 函式時所要求的資料。 當您指定 READ_THREAD_PROFILING_FLAG_DISPATCHING 旗標時，會設定下列成員：

• CoNtextSwitchCount
• CycleTime
• RetryCount
• WaitReasonBitMap

當您指定 READ_THREAD_PROFILING_FLAG_HARDWARE_COUNTERS 旗標時，會設定下列成員：

• HwCounters
• HwCountersCount

規格需求

最低支援的用戶端	Windows 7 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 R2 [僅限傳統型應用程式]
標頭	winnt.h (包括 Windows.h)

另請參閱

ReadThreadProfilingData