Share via


D3DPERF_BeginEvent函式

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

語法

int WINAPI D3DPERF_BeginEvent(
  D3DCOLOR col,
  LPCWSTR wszName
);

參數

col

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

wszName

事件名稱。

傳回值

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

備註

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

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

規格需求

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