DXGK_HISTORY_BUFFER_HEADER 구조체(d3dkmddi.h)

  • 아티클

데이터가 DXGK_HISTORY_BUFFER 기록 버퍼에 저장되는 방법을 지정합니다.

구문

typedef struct _DXGK_HISTORY_BUFFER_HEADER {
  UINT32 RenderCbSequence;
  UINT32 NumTimestamps;
  UINT32 PrivateDataSize;
  UINT32 Reserved;
} DXGK_HISTORY_BUFFER_HEADER;

멤버

RenderCbSequence

D3DDDICB_RENDERFLAGS 값입니다. pfnRenderCb 함수 호출에 사용할 값 멤버입니다.

디스플레이 미니포트 드라이버는 pfnRenderCb를 호출하기 전에 이 값을 계산하고 DXGK_HISTORY_BUFFER_HEADER 입력해야 합니다.

NumTimestamps

DMA 버퍼가 실행을 완료할 때 기록 버퍼에 있는 타임스탬프를 나타내는 수입니다.

ETW(Windows용 이벤트 추적) 시설에 기록하기 전에 버퍼의 형식을 지정해야 하는 경우에도 드라이버에 기록된 모든 타임스탬프를 포함해야 합니다.

PrivateDataSize

드라이버가 저장하는 선택적 개인 데이터의 크기(바이트)입니다. 드라이버는 어떤 용도로든 이 데이터를 사용할 수 있습니다.

0이면 드라이버가 기록 버퍼에 프라이빗 데이터를 저장할 필요가 없습니다.

참고 타임스탬프를 64비트 경계에 맞추려면 이 값이 8바이트의 배수여야 합니다.
 
DMA 버퍼가 실행을 완료할 때 기록 버퍼의 형식을 지정할 필요가 없는 경우 DirectX 그래픽 커널 하위 시스템이 ETW에 로그를 쓸 때 PrivateDataSize 를 헤더의 직접 오프셋으로 사용하여 타임스탬프를 참조합니다.

Reserved

시스템 사용을 위해 예약되며 0으로 설정해야 합니다.

설명

기록 버퍼의 타임스탬핑 부분과 타임스탬프는 ETW에 기록됩니다. 헤더 데이터 및 프라이빗 드라이버 데이터는 타임스탬프를 버퍼의 일부로 ETW에 기록하지 않습니다. 그러나 헤더의 일부는 별도로 기록됩니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 8.1,WDDM 1.3 이상
지원되는 최소 서버 Windows Server 2012 R2
머리글 d3dkmddi.h(D3dkmddi.h 포함)

추가 정보

D3DDDICB_RENDERFLAGS

DXGK_HISTORY_BUFFER

pfnRenderCb