다음을 통해 공유


PIXEndCapture

PIXBeginCapture(으)로 시작된 프로그래밍 방식으로 제어되는 캡처를 중지합니다.

구문

HRESULT PIXEndCapture(  
         BOOL discard  
)  

매개 변수

discard   
형식: BOOL

캡처가 삭제되는지 여부를 나타냅니다.

  • discard가 TRUE이면 캡처된 데이터가 삭제되고 캡처가 PIX에 표시되지 않습니다.
  • discard가 FALSE이면 캡처된 데이터가 저장되고 PIX에 결과 캡처가 표시됩니다.

discard 매개 변수는 원하는 조건을 충족하지 않는 캡처를 버릴 때 유용합니다. 예를 들어 PIXBeginCapturePIXEndCapture을(를) 사용하여 미리 정의된 시간 범위 내에 있는 함수 호출을 캡처하도록 시도할 수 있습니다. 해당 범위 내에 있는 함수 호출에 대한 캡처만 표시해야 할 수 있습니다.

반환 값

형식: 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 콘솔

참고 항목

PIXBeginCapture
PIX3
PIX(NDA 항목)권한 부여 필요