ProcessOn と ProcessOffProcessOn and ProcessOff

VSPerfCmd.exe の ProcessOff サブコマンドと ProcessOn サブコマンドでは、コマンド ライン プロファイル セッションの指定されたプロセスのプロファイリングを一時停止および再開します。The VSPerfCmd.exe ProcessOff and ProcessOn subcommands pause and resume profiling for the specified process in a command-line profiling session. ProcessOff がプロセスのプロファイリングを停止し、ProcessOn がプロセスのプロファイリングを開始します。ProcessOff stops profiling the process and ProcessOn starts profiling the process.

多くの場合、ProcessOn または ProcessOff を VSPerfCmd.exe コマンド ラインの唯一のオプションとして指定しますが、これらを GlobalOnGlobalOffThreadOn、および ThreadOff の各サブコマンドと組み合わせて使用することもできます。In most cases, you specify ProcessOn or ProcessOff as the only option in a VSPerfCmd.exe command line, but they can also be combined with the GlobalOn, GlobalOff, ThreadOn, and ThreadOff subcommands.

ProcessOn サブコマンドと ProcessOff サブコマンドは、コマンド ライン プロファイル セッションのすべてのプロセスについてのデータ収集を制御する GlobalOn サブコマンドと GlobalOff サブコマンド、および指定されたスレッドについてのデータ収集を制御する ThreadOn サブコマンドと ThreadOff サブコマンドと対話します。The ProcessOn and ProcessOff subcommands interact with the GlobalOn and GlobalOff subcommands that control data collection for all processes in a command-line profiling session, and the ThreadOn and ThreadOff subcommands that control data collection for a specified thread.

ProcessOff サブコマンドと ProcessOn サブコマンドは、プロファイラー API 関数によって操作されるプロセスの開始/停止数にも影響します。The ProcessOff and ProcessOn subcommands also affect the Process Start/Stop count that is manipulated by profiler API functions.

  • ProcessOff は、プロセスの開始/停止数を直ちに 0 に設定して、プロファイリングを一時停止します。ProcessOff immediately sets the Process Start/Stop Count to 0 and therefore pauses profiling.

  • ProcessOn は、プロセスの開始/停止数を直ちに 1 に設定して、プロファイリングを再開します。ProcessOn immediately sets the Process Start/Stop Count to 1 and therefore resumes profiling.

    詳細については、「プロファイリング ツールの API」 を参照してください。For more information, see Profiling Tools APIs.

構文Syntax

VSPerfCmd.exe /{ProcessOff|ProcessOn}:PID [Options]  

パラメーターParameters

PID
開始または停止するプロセスの整数の ID。The integer identifier of the process to start or stop. プロセス ID は、Windows タスク マネージャーの [プロセス] タブにリストされます。Process IDs are listed on the Process tab of Windows Task Manager.

必須のサブコマンドRequired Subcommands

なしNone

有効なサブコマンドValid Subcommands

ProcessOnProcessOff は、次のサブコマンドも含むコマンド ラインで指定できます。ProcessOn and ProcessOff can be specified on command lines that also contain the following subcommands.

Start: MethodStart: Method
コマンド ライン プロファイル セッションを初期化し、指定されたプロファイル方法を設定します。Initializes the command-line profiling session and sets the specified profiling method.

Launch: AppNameLaunch: AppName
指定したアプリケーションを起動し、サンプリング メソッドでプロファイリングを開始します。Starts the specified application and begins profiling with the sampling method.

Attach: PIDAttach: PID
指定されたプロセスのプロファイリングを開始します。Begins profiling the specified process.

GlobalOff|GlobalOnGlobalOff|GlobalOn
コマンド ライン プロファイル セッションのすべてのプロセスのプロファイリングを停止または開始します。Stops or starts profiling for all processes in a command-line profiling session.

{ThreadOff|ThreadOn}:TID{ThreadOff|ThreadOn}:TID
指定されたスレッドのプロファイリングを停止または開始します (インストルメンテーション メソッドのみ)。Stops or starts profiling for the specified thread (instrumentation method only).

Example

この例では、ProcessOff サブコマンドを使用してアプリケーション起動のプロファイル データを収集します。In this example, the ProcessOff subcommand is used to collect profiling data for application startup.

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

関連項目See Also

VSPerfCmd VSPerfCmd
スタンドアロン アプリケーションのプロファイリング Profiling Stand-Alone Applications
ASP.NET Web アプリケーションのプロファイリング Profiling ASP.NET Web Applications
プロファイリング (サービスの)Profiling Services