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 형식으로 표시된 사용자 모드 드라이버에서 프로필 형식 마커 이벤트를 설정할 때 다음 지침을 따릅니다.
- 그래픽 명령 경계와 강력한 상관 관계를 생성하지 않는 경량 계측을 사용합니다.
- 드라이버는 그래픽 파이프라인의 끝에서 GPU 타임스탬프를 샘플링할 수 있어야 합니다.
- 유휴 대기 명령과 같이 그래픽 파이프라인에 높은 성능 부담을 주는 샘플링 명령을 사용하지 마세요. 프로필 형식 마커 이벤트를 계측하려면 드라이버가 파이프라인 또는 캐시를 플러시할 필요가 없습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8.1,WDDM 1.3 이상 |
| 지원되는 최소 서버 | Windows Server 2012 R2 |
| 대상 플랫폼 | 데스크톱 |
| 머리글 | d3dumddi.h(D3d10umddi.h 포함) |