D3DPERF_BeginEvent函式

標記使用者定義事件的開頭。 PIX 可以使用這個事件來觸發動作。

語法

int WINAPI D3DPERF_BeginEvent(
  D3DCOLOR col,
  LPCWSTR wszName
);

參數

col

事件色彩。 這是在事件檢視中顯示事件的色彩。

wszName

事件名稱。

傳回值

這個事件從中開始之階層的以零起始的層級。 如果發生錯誤，傳回值將會是負數。

備註

使用者定義事件會以對目的程式有意義的方式，將其他事件分組在一起，使其更能以效能分析工具表示。 例如， Draw Spaceship 事件可能會將一些 Direct3D 呼叫括弧在遊戲中處理繪製太空船。 事件可以是巢狀的。

每個 D3DPERF_BeginEvent 呼叫都應該有相符 的D3DPERF_EndEvent 呼叫。 未將其他) 事件加上括弧的即時事件 (應該使用D3DPERF_SetMarker 來加上標籤，而不是使用 D3DPERF_BeginEvent 和 D3DPERF_EndEvent來標示。

規格需求

目標平台	Windows
標頭	d3d9.h
程式庫	d3d9.lib
Dll	d3d9.dll