GlobalOn と GlobalOff

VSPerfCmd.exe の GlobalOff オプションと GlobalOn オプションは、コマンド ライン プロファイル セッションのすべてのプロセスとスレッドのプロファイリングを一時停止および再開するために使用されます。

GlobalOn および GlobalOff は、VSPerfCmd.exe コマンド ラインの唯一のオプションとして指定することも、Start オプション、Launch オプション、または Attach オプションを含んでいるコマンド ラインに含めることもできます。

GlobalOnGlobalOff は、ProcessOnProcessOffThreadOnThreadOff の各オプションと組み合わせて使用することもできます。

GlobalOn オプションと GlobalOff オプションは、指定したプロセスのデータ収集を制御する ProcessOn オプションおよび ProcessOff オプション、指定したスレッドのデータ収集を制御する ThreadOn オプションおよび ThreadOff オプションと対話します。

GlobalOff オプションと GlobalOn オプションは、プロファイラーの API 関数によって操作されるグローバルな開始/停止数にも影響します。

  • GlobalOff は、グローバルな開始/停止数を直ちに 0 に設定して、プロファイリングを一時停止します。

  • GlobalOn は、グローバルな開始/停止数を直ちに 1 に設定して、プロファイリングを再開します。

    詳細については、「プロファイリング ツールの API」 を参照してください。

構文

VSPerfCmd.exe /{GlobalOff|GlobalOn}  

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

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

パラメーター

なし

有効なオプション

GlobalOnGlobalOff は、次のオプションを含んでいるコマンド ラインで指定できます。

Start: Method
コマンド ライン プロファイラー セッションを初期化し、指定されたプロファイル方法を設定します。

Launch: AppName
指定したアプリケーションを起動し、サンプリング メソッドでプロファイリングを開始します。

Attach: PID
指定されたプロセスのプロファイリングを開始します。

{ProcessOff|ProcessOn}:PID
指定されたプロセスのプロファイリングを停止または開始します。

{ThreadOff|ThreadOn}:TID
指定されたプロセスのプロファイリングを停止または開始します (インストルメンテーション メソッドのみ)。

次の例では、アプリケーションの起動およびシャットダウンのプロファイル データを収集しないようにするために、GlobalOff オプションと GlobalOn オプションを使用しています。

; 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  

関連項目

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