Passer au contenu principal

PIXEndCapture

Arrête une capture contrôlée par programmation qui a été démarrée avec PIXBeginCapture.

Syntaxe

Paramètres

discard   
Type : BOOL
Indique si la capture doit être ignorée :
  • Si discard a la valeur TRUE, les données capturées sont ignorées et la capture ne sera pas affichée dans PIX.
  • Si discard a la valeur FALSE, les données capturées sont enregistrées et PIX affichera la capture obtenue.
Le paramètre discard est utile pour éliminer les captures qui ne répondent pas aux critères recherchés. Par exemple, vous pouvez utiliser PIXBeginCapture et PIXEndCapture pour tenter de capturer les appels à une fonction qui se situent dans une plage de temps prédéfinie. Vous pourriez vouloir afficher uniquement les captures des appels à une fonction qui se situent dans cette plage.

Valeur de retour

Type : HRESULT Indique si la capture s’est terminée avec succès. S_OK est retourné en cas de réussite. L’opération est asynchrone et retourne E_PENDING jusqu’à ce que la capture soit complètement arrêtée. Le titre ne doit pas quitter ni démarrer une nouvelle capture tant que le résultat est E_PENDING.

Remarques

Utilisez PIXBeginCapture pour commencer une capture PIX.
Pour plus d’informations sur les exigences relatives au démarrage d’une capture PIX, consultez la section Remarques de PIXBeginCapture.
L’exemple C++ suivant montre comment commencer et terminer une capture PIX.

Configuration requise

En-tête : pix3.h Bibliothèque : pixevt.lib Plateformes prises en charge : consoles de la famille XBOX One et consoles XBOX Series

Voir aussi

PIXBeginCapture
PIX3
PIX (rubrique sous NDA)
Dernière modification le 6 octobre 2026