次の方法で共有

D3DPERF_BeginEvent関数

  • [アーティクル]

ユーザー定義イベントの開始をマークします。 PIX は、このイベントを使用してアクションをトリガーできます。

構文

int WINAPI D3DPERF_BeginEvent(
  D3DCOLOR col,
  LPCWSTR wszName
);

パラメーター

col

イベントの色。 これは、イベント ビューにイベントを表示する色です。

wszName

イベント名。

戻り値

このイベントが開始される階層の 0 から始まるレベル。 エラーが発生した場合、戻り値は負になります。

解説

ユーザー定義イベントは、ターゲット プログラムにとって意味のある方法で他のイベントをグループ化して、パフォーマンス プロファイル ツールでより適切に表現できるようにします。 たとえば、 Draw Spaceship イベントでは、ゲーム内の宇宙船の描画を処理する Direct3D 呼び出しの数を角かっこで囲む場合があります。 イベントは入れ子にすることができます。

各 D3DPERF_BeginEvent 呼び出しには、一致する D3DPERF_EndEvent 呼び出しが必要です。 瞬間イベント (他のイベントをかっこで囲まない) には、D3DPERF_BeginEventとD3DPERF_EndEventではなく、D3DPERF_SetMarkerを使用してラベル付けする必要があります。

必要条件

   
対象プラットフォーム Windows
ヘッダー d3d9.h
Library d3d9.lib
[DLL] d3d9.dll