Référence : commandes vcperf

Cet article répertorie et décrit les commandes disponibles dans vcperf.exe, et comment les utiliser.

Commandes pour démarrer et arrêter les traces

Important

Sauf si vous spécifiez /noadmin, les commandes suivantes nécessitent des privilèges d’administration.

Option	Arguments et description
/start	[/noadmin] [] [] [ | | /level3/nocpusampling/level1/level2]<sessionName>
	Démarre une trace sous le nom de session donné. L’option /noadmin s’exécute vcperf.exe sans privilèges d’administrateur et ignore l’option /nocpusampling . Lorsque vous exécutez vcperf sans privilèges d’administrateur, il peut y avoir plusieurs sessions actives sur un ordinateur donné. L’option /nocpusampling spécifie vcperf.exe ne collecte pas d’exemples d’UC. Elle empêche l’utilisation de la vue Utilisation du processeur (échantillonnée) dans Windows Analyseur de performances, mais réduit la taille des traces collectées. Les /level1options ou /level3 les événements /level2MSVC à collecter, en augmentant le niveau d’informations. Le niveau 3 inclut tous les événements. Le niveau 2 inclut tous les événements, à l’exception des événements d’instanciation de modèle. Le niveau 1 inclut tous les événements, à l’exception de l’instanciation du modèle, de la fonction et des événements de fichier. S’il n’est pas spécifié, /level2 est sélectionné par défaut. Une fois vcperf.exe démarre la trace, elle est retournée immédiatement. La trace collecte les événements à l’échelle du système pour tous les processus s’exécutant sur l’ordinateur. Cela signifie que vous n’avez pas besoin de générer votre projet dans la même fenêtre d’invite de commandes que celle que vous utilisez pour exécuter vcperf.exe. Par exemple, vous pouvez générer votre projet dans Visual Studio.
/stop	(1) [/templates] <sessionName> <outputFile.etl> (2) [/templates] <sessionName> /timetrace <outputFile.json>
	Arrête la trace identifiée par le nom de session donné. Exécute une étape de post-traitement sur la trace pour générer un fichier spécifié par le <outputFile> paramètre. L’option /templates inclut des événements d’instanciation de modèle dans le fichier. (1) Génère un fichier visible dans Windows Analyseur de performances (WPA). Le fichier de sortie nécessite une .etl extension. (2) Génère un fichier visible dans la visionneuse de trace Microsoft Edge (edge://tracing). Le fichier de sortie nécessite une .json extension.
/stopnoanalyze	<sessionName> <rawOutputFile.etl>
	Arrête la trace identifiée par le nom de session donné et écrit les données brutes et non traitées dans le fichier de sortie spécifié. Le fichier résultant n’est pas destiné à l’affichage dans WPA. L’étape de post-traitement impliquée dans la /stop commande peut parfois être longue. Vous pouvez utiliser la /stopnoanalyze commande pour retarder cette étape de post-traitement. Utilisez la /analyze commande lorsque vous êtes prêt à produire un fichier visible dans Windows Analyseur de performances ou la visionneuse de trace Microsoft Edge.

Commandes diverses

Option	Arguments et description
/analyze	(1) [/templates] <rawInputFile.etl> <outputFile.etl> (2) [/templates] <rawInputFile.etl> /timetrace <outputFile.json>
	Accepte un fichier de trace brut généré par la /stopnoanalyze commande. Exécute une étape de post-traitement sur cette trace pour générer le fichier spécifié par le <outputFile> paramètre. L’option /templates inclut des événements d’instanciation de modèle dans le fichier. (1) Génère un fichier visible dans Windows Analyseur de performances (WPA). Le fichier de sortie nécessite une .etl extension. (2) Génère un fichier visible dans la visionneuse de trace Microsoft Edge (edge://tracing). Le fichier de sortie nécessite une .json extension.

Voir aussi

Bien démarrer avec C++ Build Insights
Tutoriel : Concepts de base de Windows Analyseur de performances
Référence : Vues windows Analyseur de performances
Windows Performance Analyzer