PIXBeginCapture

Démarre une capture de minutage PIX contrôlée par programmation.

Syntaxe

HRESULT PIXBeginCapture(  
         DWORD captureFlags,  
         const PPIXCaptureParameters captureParameters  
)  

Paramètres

captureFlags
Type : DWORD Indicateur précisant le type de capture à effectuer. Un seul indicateur de capture peut être transmis à la fois à PIXBeginCapture. captureParameters _In_opt_
Type : PPIXCaptureParameters Pour les captures de minutage, transmettez un pointeur vers la structure TimingCaptureParameters, ou un pointeur vers l’union PIXCaptureParameters, qui contient la structure TimingCaptureParameters.

Valeur de retour

Type : HRESULT Indique si la capture a été lancée avec succès. S_FALSE est retourné en cas de réussite. Une seule capture peut être en cours d’exécution à la fois. Si PIXBeginCapture est appelée alors qu’une autre capture est en cours d’exécution, E_PENDING est retourné et l’appel n’a aucun effet.

Indicateurs

Indicateur	Valeur	Description
PIX_CAPTURE_TIMING	(1 << 0)	Minutage système.
PIX_CAPTURE_GPU	(1 << 1)	Capture toutes les commandes envoyées au GPU ainsi que leurs entrées afin de pouvoir les relire et les analyser.
PIX_CAPTURE_FUNCTION_SUMMARY	(1 << 2)	Une capture de résumé des fonctions a été lancée à partir de l’onglet Home.
PIX_CAPTURE_FUNCTION_DETAILS	(1 << 3)	Une demande de détails supplémentaires sur les fonctions a été lancée à l’aide du bouton Capture Additional Calls à partir d’une capture de résumé des fonctions ou d’une capture de graphe des appels.
PIX_CAPTURE_CALLGRAPH	(1 << 4)	Une capture de graphe des appels a été lancée à partir de PIX ou par programmation en appelant `PIXBeginCapture`.
PIX_CAPTURE_INSTRUCTION_TRACE	(1 << 5)	Une capture de trace des instructions du processeur est en cours.
PIX_CAPTURE_SYSTEM_MONITOR_COUNTERS	(1 << 6)	Compteurs du moniteur système.
PIX_CAPTURE_VIDEO	(1 << 7)	Lecture vidéo.
PIX_CAPTURE_AUDIO	(1 << 8)	Lecture audio.
PIX_CAPTURE_GPU_TRACE	(1 << 9)	Capture les compteurs SPM (Streaming Performance Monitor) du GPU et les données SQTT (Shader Queue Thread Tracing) de presque tous les blocs du GPU.
PIX_CAPTURE_RESERVED	(1 << 15)	Indicateur d’espace réservé utilisé en interne par PIX pour des scénarios de capture futurs ou spécialisés.

Remarques

Cette fonction lance une capture PIX à partir du code du titre. PIXBeginCapture ne peut actuellement être utilisée que pour effectuer une capture de minutage (rubrique sous NDA). PIXBeginCapture stocke les données de capture dans la mémoire des outils sur la console. La quantité de mémoire des outils mise à la disposition de la capture est spécifiée en définissant le champ MaximumToolingMemorySizeMb de la structure PIXCaptureParameters. Les captures de minutage par programmation peuvent être effectuées dans l’un de deux modes, définis par la valeur de l’énumération PIXCaptureStorage dans la structure PIXCaptureParameters. Lorsque PIXCaptureStorage a la valeur Memory, PIXBeginCapture remplit la mémoire des outils disponible, puis ignore toutes les nouvelles données reçues. Lorsque PIXCaptureStorage a la valeur MemoryCircular, PIXBeginCapture utilise la mémoire des outils comme une mémoire tampon circulaire. La capture s’exécute jusqu’à ce que la mémoire des outils soit pleine, mais au lieu d’arrêter la capture, les données les plus anciennes sont supprimées pour faire de la place aux nouvelles données. La capture continue de s’exécuter. Les captures MemoryCircular sont conçues pour s’exécuter sur de longues périodes sans épuiser la mémoire des outils disponible sur la console. Les captures de minutage effectuées à l’aide de PIXBeginCapture doivent être copiées sur le PC et converties en fichier .xpix avant de pouvoir être affichées dans PIX. Consultez Ouverture des captures de minutage par programmation (rubrique sous NDA) pour obtenir une description des étapes nécessaires à l’affichage d’une capture par programmation dans PIX. Utilisez PIXEndCapture pour arrêter une capture PIX à partir du code du titre.

//
//  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));

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

Documentation conceptuelle

Analyse des performances du processeur (sommaire)

Voir aussi

PIXEndCapture
PIXCaptureParameters
PIX3
PIX (rubrique sous NDA)

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

PIXBeginCapture

PIXBeginCapture

Syntaxe

Paramètres

Valeur de retour

Indicateurs

Remarques

Configuration requise

Documentation conceptuelle

Voir aussi

​PIXBeginCapture

​Syntaxe

​Paramètres

​Valeur de retour

​Indicateurs

​Remarques

​Configuration requise

​Documentation conceptuelle

​Voir aussi

PIXBeginCapture

Syntaxe

Paramètres

Valeur de retour

Indicateurs

Remarques

Configuration requise

Documentation conceptuelle

Voir aussi