PFND3DWDDM1_3DDI_SETMARKERMODE 콜백 함수(d3d10umddi.h)

사용자 모드 표시 드라이버에 ETW(Windows용 이벤트 추적) 마커 이벤트 유형을 지원해야 한다는 것을 알 수 있습니다. WDDM(Windows Display Driver Model) 1.3 이상 드라이버에서 구현해야 합니다.

구문

PFND3DWDDM1_3DDI_SETMARKERMODE Pfnd3dwddm13DdiSetmarkermode;

void Pfnd3dwddm13DdiSetmarkermode(
  D3D10DDI_HDEVICE hDevice,
  D3DWDDM1_3DDI_MARKER_TYPE Type,
  UINT Flags
)
{...}

매개 변수

hDevice

디스플레이 디바이스(그래픽 컨텍스트)에 대한 핸들입니다.

Type

드라이버에서 지원해야 하는 마커 이벤트의 유형을 나타내는 D3DWDDM1_3DDI_MARKER_TYPE 열거형의 값입니다.

Flags

드라이버가 명령 버퍼에 사용자 지정 정보를 제공해야 하는지 여부를 나타내는 UINT 값입니다. D3DWDDM1_3DDI_SETMARKERMODE_CUSTOMDRIVEREVENTS 설정하면 드라이버는 사용자 지정 이벤트 정보를 사용하여 명령 버퍼에 주석을 달고 계측해야 합니다. 그렇지 않으면 드라이버가 명령 버퍼에 주석을 달지 않아야 합니다.

주석은 영어-미국 로캘의 텍스트 문자열 형식이거나 문자열 테이블의 위치에 대한 인덱스 값 형식일 수 있습니다. 후자 옵션의 경우 드라이버는 인덱스 값이 나타내는 문자열을 설명하는 함수도 구현해야 합니다.

반환 값

없음

설명

드라이버는 pfnSetErrorCb 콜백 함수를 사용하여 오류 코드를 설정할 수 있습니다.

D3DWDDM1_3DDI_MARKER_TYPE_PROFILE 형식으로 표시된 사용자 모드 드라이버에서 프로필 형식 마커 이벤트를 설정할 때 다음 지침을 따릅니다.

  • 그래픽 명령 경계와 강력한 상관 관계를 생성하지 않는 경량 계측을 사용합니다.
  • 드라이버는 그래픽 파이프라인의 끝에서 GPU 타임스탬프를 샘플링할 수 있어야 합니다.
  • 유휴 대기 명령과 같이 그래픽 파이프라인에 높은 성능 부담을 주는 샘플링 명령을 사용하지 마세요. 프로필 형식 마커 이벤트를 계측하려면 드라이버가 파이프라인 또는 캐시를 플러시할 필요가 없습니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows 8.1,WDDM 1.3 이상
지원되는 최소 서버 Windows Server 2012 R2
대상 플랫폼 데스크톱
머리글 d3d10umddi.h(D3d10umddi.h 포함)

추가 정보

D3DWDDM1_3DDI_MARKER_TYPE