次の方法で共有

GlobalOn と GlobalOff

  • [アーティクル]

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

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

GlobalOn と GlobalOff は、ProcessOn、ProcessOff、ThreadOn、および ThreadOff の各オプションと組み合わせて使用することもできます。

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]

パラメーター

なし

有効なオプション

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

  • **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 アプリケーションのコマンド ライン プロファイリング

サービスのコマンド ライン プロファイリング