PIXEndCapture
PIXBeginCapture
(으)로 시작된 프로그래밍 방식으로 제어되는 캡처를 중지합니다.
구문
HRESULT PIXEndCapture(
BOOL discard
)
매개 변수
discard
형식: BOOL
캡처가 삭제되는지 여부를 나타냅니다.
- discard가 TRUE이면 캡처된 데이터가 삭제되고 캡처가 PIX에 표시되지 않습니다.
- discard가 FALSE이면 캡처된 데이터가 저장되고 PIX에 결과 캡처가 표시됩니다.
discard 매개 변수는 원하는 조건을 충족하지 않는 캡처를 버릴 때 유용합니다. 예를 들어 PIXBeginCapture
및 PIXEndCapture
을(를) 사용하여 미리 정의된 시간 범위 내에 있는 함수 호출을 캡처하도록 시도할 수 있습니다. 해당 범위 내에 있는 함수 호출에 대한 캡처만 표시해야 할 수 있습니다.
반환 값
형식: HRESULT
캡처가 성공적으로 완료되었는지 여부를 나타냅니다. 성공하면 S_OK가 반환됩니다. 작업은 비동기적이며 캡처가 완전히 중지될 때까지 E_PENDING을 반환합니다. 결과가 E_PENDING인 동안 타이틀은 새 캡처를 끝내거나 새로 시작해서는 안 됩니다.
설명
PIXBeginCapture를 사용하여 PIX 캡처를 시작합니다.
PIX 캡처를 시작하기 위한 요구 사항에 관한 자세한 내용은 PIXBeginCapture의 설명 섹션을 참조하세요.
다음 C++ 샘플은 PIX 캡처를 시작하고 종료하는 방법을 보여 줍니다.
//
// timing capture
//
PIXCaptureParameters captureParams = {};
captureParams.TimingCaptureParameters.CaptureGpuTiming = TRUE;
captureParams.TimingCaptureParameters.CaptureCallstacks = TRUE;
captureParams.TimingCaptureParameters.CaptureCpuSamples = TRUE;
captureParams.TimingCaptureParameters.CpuSamplesPerSecond = 4000;
captureParams.TimingCaptureParameters.CaptureStorage = PIXCaptureParameters::Memory;
captureParams.TimingCaptureParameters.FileName = wstrFilename;
captureParams.TimingCaptureParameters.MaximumToolingMemorySizeMb = 4096;
XSF_ERROR_IF_FAILED(PIXBeginCapture(PIX_CAPTURE_TIMING, &captureParams));
while (PIXEndCapture(FALSE) == E_PENDING)
{
// Keep running
}
요건
헤더: pix3.h
라이브러리: pixevt.lib
지원되는 플랫폼: Xbox One 패밀리 콘솔 및 Xbox Series 콘솔