PFND3D10DDI_QUERYBEGIN 콜백 함수(d3d10umddi.h)

  • 아티클

QueryBegin 함수는 쿼리에 대한 그래픽 명령 시퀀스의 시작을 표시하고 쿼리를 "building" 상태로 전환합니다.

구문

PFND3D10DDI_QUERYBEGIN Pfnd3d10ddiQuerybegin;

void Pfnd3d10ddiQuerybegin(
  D3D10DDI_HDEVICE unnamedParam1,
  D3D10DDI_HQUERY unnamedParam2
)
{...}

매개 변수

unnamedParam1

hDevice [in]

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

unnamedParam2

hQuery [in]

시작할 쿼리 개체에 대한 핸들입니다.

반환 값

없음

설명

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

드라이버는 D3D10DDI_QUERY_EVENT 또는 D3D10DDI_QUERY_TIMESTAMP 쿼리 작업에 대해 QueryBegin 함수를 지원할 필요가 없습니다. 이러한 쿼리 작업에는 암시적 시작이 있습니다.

Microsoft Direct3D 런타임은 SetPredication 함수를 호출하여 현재 파이프라인에 바인딩된 조건자에서 QueryBegin을 호출할 수 없습니다.

D3DDDIERR_DEVICEREMOVED 경우를 제외하고 드라이버에 오류가 발생하지 않아야 합니다. 따라서 드라이버가 pfnSetErrorCb 함수를 호출할 때 D3DDDIERR_DEVICEREMOVED 경우를 제외하고 오류를 전달하는 경우 Direct3D 런타임은 오류가 중요하다고 결정합니다. 디바이스가 제거된 경우에도 드라이버는 D3DDDIERR_DEVICEREMOVED 반환할 필요가 없습니다. 그러나 디바이스 제거가 QueryBegin 작업을 방해하는 경우(일반적으로 발생하지 않아야 하는) 드라이버는 D3DDDIERR_DEVICEREMOVED 반환할 수 있습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
대상 플랫폼 데스크톱
머리글 d3d10umddi.h(D3d10umddi.h 포함)

추가 정보

D3D10DDI_DEVICEFUNCS

QueryEnd

SetPredication

pfnSetErrorCb