Référence : commandes vcperf
Les outils de génération C++ Recommandations sont disponibles à partir de Visual Studio 2019 et versions ultérieures. Pour afficher la documentation de cette version, définissez le contrôle de sélecteur de version Visual Studio pour cet article sur Visual Studio 2019 ou version ultérieure. Il se trouve en haut de la table des matières de cette page.
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] [/nocpusampling] [/level1 | /level2 | /level3] <sessionName> |
| Démarre une trace sous le nom de session donné. L’option /noadmin 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 que vcperf.exe démarre la trace, elle retourne 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
Prise en main du Recommandations de build C++
Tutoriel : Concepts de base de Windows Analyseur de performances
Référence : Vues windows Analyseur de performances
Windows Performance Analyzer