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 passé à PIXBeginCapture à la fois. captureParameters _In_opt_
Type : PPIXCaptureParameters Pour les captures de minutage, passez 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 s’exécuter à 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 du 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 servir qu’à effectuer une capture de minutage (rubrique sous NDA). PIXBeginCapture stocke les données de capture dans la mémoire des outils de la console. La quantité de mémoire des outils mise à la disposition de la capture est spécifiée par le champ MaximumToolingMemorySizeMb de la structure PIXCaptureParameters. Les captures de minutage par programmation peuvent être effectuées selon 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 place aux nouvelles. La capture continue de s’exécuter. Les captures MemoryCircular sont conçues pour s’exécuter pendant 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 recopié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 pour afficher 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)

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

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