PFND3DDDI_SETMARKERMODE 콜백 함수(d3dumddi.h)

  • 아티클

사용자 모드 표시 드라이버에 ETW(Windows용 이벤트 추적) 마커 이벤트 유형을 지원해야 한다는 것을 알 수 있습니다. 필요에 따라 Microsoft Direct3D 수준 9 하드웨어에서 실행되는 WDDM(Windows Display Driver Model) 1.3 이상 드라이버에 의해 구현됩니다. ( Direct3D 렌더링 성능 향상의 요구 사항을 참조하세요.) 고급 하드웨어의 경우 드라이버는 SetMarkerMode 함수를 구현해야 합니다.

구문

PFND3DDDI_SETMARKERMODE Pfnd3dddiSetmarkermode;

HRESULT Pfnd3dddiSetmarkermode(
  HANDLE hDevice,
  D3DDDI_MARKERTYPE Type,
  UINT Flags
)
{...}

매개 변수

hDevice

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

Type

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

Flags

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

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

반환 값

함수가 성공적으로 완료되지 않으면 S_OK 또는 적절한 오류 결과를 반환합니다.

설명

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

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

요구 사항

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

추가 정보

D3DDDI_MARKERTYPE

SetMarkerMode