D3DPERF_BeginEvent 함수

사용자 정의 이벤트의 시작을 표시합니다. PIX는 이 이벤트를 사용하여 작업을 트리거할 수 있습니다.

구문

int WINAPI D3DPERF_BeginEvent(
  D3DCOLOR col,
  LPCWSTR wszName
);

매개 변수

col

이벤트 색입니다. 이벤트 보기에 이벤트를 표시하는 색입니다.

wszName

이벤트 이름입니다.

반환 값

이 이벤트가 시작되는 계층 구조의 0부터 시작하는 수준입니다. 오류가 발생하면 반환 값은 음수입니다.

설명

사용자 정의 이벤트는 성능 프로파일링 도구에서 더 잘 나타낼 수 있도록 대상 프로그램에 의미 있는 방식으로 다른 이벤트를 그룹화합니다. 예를 들어 우주선 그리기 이벤트는 게임에서 우주선 그리기를 처리하는 여러 Direct3D 호출을 대괄호로 묶을 수 있습니다. 이벤트를 중첩할 수 있습니다.

각 D3DPERF_BeginEvent 호출에는 일치하는 D3DPERF_EndEvent 호출이 있어야 합니다. 인스턴스 이벤트(다른 이벤트를 대괄호로 묶지 않음)는 D3DPERF_BeginEvent 및 D3DPERF_EndEvent 대신 D3DPERF_SetMarker 사용하여 레이블을 지정해야 합니다.

요구 사항