ID3D11ShaderTrace::TraceReady 메서드(d3d11shadertracing.h)

  • 아티클

셰이더 추적이 기록되고 사용할 준비가 되도록 지정합니다.

구문

HRESULT TraceReady(
  [out, optional] UINT64 *pTestCount
);

매개 변수

[out, optional] pTestCount

추적에 대해 일치하는 호출이 발생한 횟수를 수신하는 변수에 대한 선택적 포인터입니다. 사용하지 않으면 을 NULL로 설정합니다. 이 번호에 대한 자세한 내용은 비고를 참조하세요.

반환 값

TraceReady는 다음을 반환합니다.

  • 추적이 준비되었는지 S_OK.
  • 추적이 준비되지 않은 경우 S_FALSE.
  • 추적 이 기록되는 동안 메모리가 부족했는지 E_OUTOFMEMORY. ID3D11ShaderTrace::ResetTrace를 호출한 다음 다시 그리면 추적을 다시 기록할 수 있습니다. 추적을 다시 기록하지 않기로 결정한 경우 ID3D11ShaderTrace 인터페이스를 해제합니다.
  • Direct3D 11 반환 코드에 설명된 다른 오류 코드일 수 있습니다.

설명

추적이 호출 3을 기록하기 위한 것이지만 지금까지 두 개의 호출만 발생한 경우 TraceReady 는 pTestCount 가 가리키는 변수를 2로 설정합니다. 이 값을 사용하여 추적이 아직 준비되지 않은 이유를 이해할 수 있습니다. 반대로 pTestCount 가 가리키는 변수는 준비된 추적에 대해 요청된 호출 수보다 클 수 있습니다. 이 값을 사용하여 필요한 추적 호출 수를 지난 호출 수를 확인할 수 있습니다. 예를 들어 그리기 호출에서 지정된 셰이더의 픽셀에서 발생하는 오버드로우 수를 알 수 없습니다. 장면을 동일하게 다시 그릴 수 있는 경우 TraceReady 가 첫 번째 패스의 pTestCount 에서 반환한 값에 따라 다음에 추적을 설정할 수 있습니다.

셰이더 추적이 기록된 경우 ID3D11ShaderTrace::GetTraceStats, ID3D11ShaderTrace::GetInitialRegisterContents 및 ID3D11ShaderTrace::GetStep 메서드를 성공적으로 호출할 수 있습니다. 셰이더 추적이 기록되었는지 여부에 관계없이 ID3D11ShaderTrace::ResetTrace 및 ID3D11ShaderTrace::P SSelectStamp 메서드를 호출할 수 있습니다.

참고 이 API에는 Windows 8 Windows SDK(소프트웨어 개발 키트)가 필요합니다.
 

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 8 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2012 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 d3d11shadertracing.h
DLL D3D11SDKLayers.dll; D3D11_1SDKLayers.dll; D3D11_2SDKLayers.dll

추가 정보

ID3D11ShaderTrace