ThreadOn et ThreadOffThreadOn and ThreadOff

Les sous-commandes ThreadOff et ThreadOn de VSPerfCmd.exe sont disponibles seulement dans les sessions de profilage en ligne de commande qui utilisent la méthode d’instrumentation.The VSPerfCmd.exe ThreadOff and ThreadOn subcommands are only available in command-line profiling sessions that use the instrumentation method. ThreadOff et ThreadOn suspendent et reprennent le profilage du thread spécifié.ThreadOff and ThreadOn pause and resume profiling for the specified thread. ThreadOff arrête le profilage du thread et ThreadOn démarre le profilage du thread.ThreadOff stops profiling the thread and ThreadOn starts profiling the thread.

Dans la plupart des cas, vous spécifiez ThreadOn ou ThreadOff comme seule option d’une ligne de commande VSPerfCmd.exe, mais elles peuvent aussi être combinées avec les sous-commandes GlobalOn, GlobalOff, ProcessOn et ProcessOff.In most cases, you specify ThreadOn or ThreadOff as the only option in a VSPerfCmd.exe command line, but they can also be combined with the GlobalOn, GlobalOff, ProcessOn, and ProcessOff subcommands.

Les sous-commandes ThreadOn et ThreadOff interagissent avec les sous-commandes GlobalOn et GlobalOff, qui contrôlent la collecte de données de tous les processus d’une session de profilage en ligne de commande, et avec les sous-commandes ProcessOn et ProcessOff, qui contrôlent la collecte de données d’un processus spécifié.The ThreadOn and ThreadOff subcommands interact with the GlobalOn and GlobalOff subcommands that control data collection for all processes in a command-line profiling session, and the ProcessOn and ProcessOff subcommands that control data collection for a specified process.

Les sous-commandes ThreadOff et ThreadOn affectent également le nombre de Start/Stop du thread qui est manipulé par les fonctions d’API du profileur.The ThreadOff and ThreadOn subcommands also affect the Thread Start/Stop count that is manipulated by profiler API functions.

  • ThreadOff affecte immédiatement la valeur 0 au nombre de Start/Stop global et suspend ainsi le profilage.ThreadOff immediately sets the Thread Start/Stop Count to 0 and therefore pauses profiling.

  • ThreadOn affecte immédiatement la valeur 1 au nombre de Start/Stop du thread et reprend ainsi le profilage.ThreadOn immediately sets the Thread Start/Stop Count to 1 and therefore resumes profiling.

    Pour plus d’informations, consultez API des outils de profilage.For more information, see Profiling tools APIs.

SyntaxeSyntax

VSPerfCmd.exe /{ThreadOff|ThreadOn}:TID [Options]

ParamètresParameters

TID Identificateur sous forme d’entier du thread à démarrer ou à arrêter.TID The integer identifier of the thread to start or stop.

Options validesValid options

Vous pouvez spécifier ThreadOn et ThreadOff sur des lignes de commande qui contiennent également les sous-commandes suivantes.ThreadOn and ThreadOff can be specified on command lines that also contain the following subcommands.

Start : Method Initialise la session de profilage en ligne de commande, et définit la méthode de profilage spécifiée.Start: Method Initializes the command-line profiling session and sets the specified profiling method.

GlobalOff|GlobalOn Arrête ou démarre le profilage de tous les processus d’une session de profilage en ligne de commande.GlobalOff|GlobalOn Stops or starts profiling for all processes in a command-line profiling session.

{ProcessOff|ProcessOn:TID Arrête ou démarre le profilage du processus spécifié.{ProcessOff|ProcessOn}:TID Stops or starts profiling for the specified process.

ExempleExample

Dans cet exemple, la sous-commande ThreadOff est utilisée pour arrêter la collecte de données de profilage et collecter seulement les données de démarrage de l’application.In this example, the ThreadOff subcommand is used to stop collecting profiling data so that only application startup data is collected.

; Initialize the profiler.
VSPerfCmd.exe /Start:Trace /Output:Instrument.vsp
; Start the instrumented application.
; Stop profiling the thread after startup.
VSPerfCmd.exe /ThreadOff:12345
; Shut down the target application.
; Close the profiler.
VSPerfCmd /Shutdown

Voir aussiSee also