ThreadOn と ThreadOffThreadOn and ThreadOff

VSPerfCmd.exe の ThreadOff および ThreadOn サブコマンドは、インストルメンテーション メソッドを使用するコマンド ライン プロファイリング セッションでのみ使用できます。The VSPerfCmd.exe ThreadOff and ThreadOn subcommands are only available in command-line profiling sessions that use the instrumentation method. ThreadOff および ThreadOn は、指定されたスレッドのプロファイリングを一時停止および再開します。ThreadOff and ThreadOn pause and resume profiling for the specified thread. ThreadOff がスレッドのプロファイリングを停止し、ThreadOn がスレッドのプロファイリングを開始します。ThreadOff stops profiling the thread and ThreadOn starts profiling the thread.

多くの場合、ThreadOn または ThreadOff を VSPerfCmd.exe コマンド ラインの唯一のオプションとして指定しますが、GlobalOnGlobalOffProcessOnProcessOff の各サブコマンドと組み合わせて使用することもできます。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.

ThreadOn サブコマンドと ThreadOff サブコマンドは、コマンド ライン プロファイリング セッションのすべてのプロセスについてのデータ収集を制御する GlobalOn サブコマンドと GlobalOff サブコマンド、および指定されたプロセスについてのデータ収集を制御する ProcessOn サブコマンドと ProcessOff サブコマンドと対話します。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.

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

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

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

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

構文Syntax

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

パラメーターParameters

TID
開始または停止するスレッドの整数の ID。The integer identifier of the thread to start or stop.

有効なオプションValid Options

ThreadOnThreadOff は、次のサブコマンドも含むコマンド ラインで指定できます。ThreadOn and ThreadOff 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.

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

{ProcessOff|ProcessOn}:TID{ProcessOff|ProcessOn}:TID
指定されたプロセスのプロファイリングを停止または開始します。Stops or starts profiling for the specified process.

Example

この例では、アプリケーションのスタートアップ データのみが収集されるように、ThreadOff サブコマンドを使用してプロファイル データの収集を停止します。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  

参照See Also

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