Pular para o conteúdo principal

PIXEndCapture

Interrompe uma captura controlada programaticamente que foi iniciada com PIXBeginCapture.

Sintaxe

Parâmetros

discard   
Tipo: BOOL
Indica se a captura deve ser descartada:
  • Se discard for TRUE, os dados capturados serão descartados e a captura não será exibida no PIX.
  • Se discard for FALSE, os dados capturados serão salvos e o PIX exibirá a captura resultante.
O parâmetro discard é útil para descartar capturas que não atenderam aos critérios que você procurava. Por exemplo, você pode usar PIXBeginCapture e PIXEndCapture para tentar capturar chamadas a uma função que se enquadram em um intervalo de tempo predefinido. Talvez você queira exibir apenas as capturas de chamadas a uma função que se enquadram nesse intervalo.

Valor retornado

Tipo: HRESULT Indica se a captura foi concluída com êxito. S_OK é retornado em caso de êxito. A operação é assíncrona e retornará E_PENDING até que a captura seja totalmente interrompida. O título não deve sair nem iniciar uma nova captura enquanto o resultado for E_PENDING.

Comentários

Use PIXBeginCapture para iniciar uma captura do PIX.
Para obter mais informações sobre os requisitos para iniciar uma captura do PIX, consulte a seção Comentários de PIXBeginCapture.
O exemplo em C++ a seguir demonstra como iniciar e encerrar uma captura do PIX.

Requisitos

Cabeçalho: pix3.h Biblioteca: pixevt.lib Plataformas com suporte: consoles da família XBOX One e consoles XBOX Series

Confira também

PIXBeginCapture
PIX3
PIX (tópico sob NDA)
Última modificação em 6 de outubro de 2026