GlobalOn et GlobalOffGlobalOn and GlobalOff

Les options GlobalOff et GlobalOn de VSPerfCmd.exe suspendent et reprennent le profilage pour tous les processus et threads dans une session de profilage en ligne de commande.The VSPerfCmd.exe GlobalOff and GlobalOn options pause and resume profiling for all processes and threads in a command-line profiling session.

Vous pouvez spécifier GlobalOn et GlobalOff comme uniques options sur une ligne de commande VSPerfCmd.exe, ou vous pouvez les inclure sur des lignes de commande qui contiennent aussi les options Start, Launch ou Attach.You can specify GlobalOn and GlobalOff as the only options in a VSPerfCmd.exe command line, or you can include them in command lines that also contain the Start, Launch, or Attach options.

Vous pouvez aussi combiner GlobalOn et GlobalOff avec les options ProcessOn, ProcessOff, ThreadOn et ThreadOff.GlobalOn and GlobalOff can also be combined with the ProcessOn, ProcessOff, ThreadOn, and ThreadOff options.

Les options GlobalOn et GlobalOff interagissent avec les options ProcessOn et ProcessOff qui contrôlent la collecte de données pour un processus spécifié, et avec les options ThreadOn et ThreadOff qui contrôlent la collecte de données pour un thread spécifié.The GlobalOn and GlobalOff options interact with the ProcessOn and ProcessOff options that control data collection for a specified process, and with the ThreadOn and ThreadOff options that control data collection for a specified thread.

Les options GlobalOff et GlobalOn affectent également le nombre Start/Stop global manipulé par les fonctions d’API du profileur.The GlobalOff and GlobalOn options also affect the Global Start/Stop count that is manipulated by the profiler's API functions.

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

  • GlobalOff affecte immédiatement la valeur 1 au Nombre Start/Stop global et reprend ainsi le profilage.GlobalOn immediately sets the Global 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 /{GlobalOff|GlobalOn}

VSPerfCmd.exe /Start:Method /{GlobalOff|GlobalOn} [Options]

VSPerfCmd.exe {Launch:AppName|Attach:PID} /{GlobalOff|GlobalOn}[Options]

ParametersParameters

AucunNone

Options validesValid Options

Vous pouvez spécifier GlobalOn et GlobalOff sur des lignes de commande qui contiennent également les options suivantes.GlobalOn and GlobalOff can be specified on command lines that also contain the following options.

Démarrer : Method initialise la session de profileur de ligne de commande et définit la méthode de profilage spécifiée.Start: Method Initializes the command-line profiler session and sets the specified profiling method.

Launch : AppName démarre l’application spécifiée et commence le profilage à l’aide de la méthode d’échantillonnage.Launch: AppName Starts the specified application and begins profiling with the sampling method.

Attacher : PID commence le profilage du processus spécifié.Attach: PID Begins profiling the specified process.

{ProcessOff|ProcessOn} : PID s’arrête ou démarre le profilage pour le processus spécifié.{ProcessOff|ProcessOn}:PID Stops or starts profiling for the specified process.

{ThreadOff|ThreadOn} : TID s’arrête ou démarre le profilage pour le processus spécifié (méthode d’instrumentation uniquement).{ThreadOff|ThreadOn}:TID Stops or starts profiling for the specified process (instrumentation method only).

ExempleExample

Dans cet exemple, les options GlobalOff et GlobalOn permettent d’éviter la collecte de données de profilage pour le démarrage et l’arrêt de l’application.In this example, the GlobalOff and GlobalOn options are used to avoid collecting profiling data for application startup and shutdown.

; Initialize the profiler with profiling stopped.
VSPerfCmd.exe /Start:Trace /Output:Instrument.vsp /GlobalOff
; Start an instrumented application and wait for it to warm up.
; Start profiling.
VSPerfCmd.exe /GlobalOn
; Exercise the application functionality that you want to profile.
; Stop profiling.
VSPerfCmd.exe /GlobalOff
; Shut down the target application.
; Close the profiler.
VSPerfCmd /Shutdown

Voir aussiSee also