Подкоманды ProcessOn и ProcessOff

Статья
06/08/2015

Подкоманды ProcessOff и ProcessOn программы VSPerfCmd.exe приостанавливают и возобновляют профилирование заданного процесса в сеансе профилирования из командной строки.ProcessOff останавливает профилирование процесса, а ProcessOn запускает профилирование процесса.

В большинстве случаев параметр ProcessOn или ProcessOff можно задать как единственный параметр командной строки программы VSPerfCmd.exe либо в сочетании с подкомандами GlobalOn, GlobalOff, ThreadOn и ThreadOff.

Подкоманды ProcessOn и ProcessOff также взаимодействуют с подкомандами GlobalOn и GlobalOff, которые обеспечивают управление сбором данных для всех процессов сеанса профилирования с использованием командной строки, и с подкомандами ThreadOn и ThreadOff, которые позволяют управлять сбором данных в заданном потоке.

Подкоманды ProcessOff и ProcessOn также влияют на количество запусков и остановки процесса, которое задается функциями интерфейса API профилирования.

Подкоманда ProcessOff непосредственно задает количество запусков и остановок процесса равным 0, вследствие чего процесс профилирования приостанавливается.
Подкоманда ProcessOn непосредственно задает количество запусков и остановок процесса равным 1, вследствие чего процесс профилирования возобновляется.

Для получения дополнительной информации см. Интерфейсы API средств профилирования.

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

Параметры

PID
Целочисленный идентификатор запускаемого или останавливаемого процесса.Идентификаторы процесса перечисляются на вкладке "Процесс" диспетчера задач Windows.

Необходимые подкоманды

Нет

Допустимые подкоманды

Параметры ProcessOn и ProcessOff могут быть заданы в командной строке, содержащей следующие подкоманды.

Start: Method
Инициализирует сеанс профилирования из командной строки и задает указанный метод профилирования.
Launch: AppName
Запускает заданное приложение и начинает профилирование с помощью метода выборки.
Attach: PID
Начинает профилирование заданного процесса.
GlobalOff|GlobalOn
Начинает или останавливает профилирование для всех процессов сеанса профилирования из командной строки.
{ThreadOff|ThreadOn}**:**TID
Останавливает или запускает профилирование заданного потока (только метод инструментирования).

Пример

В данном примере подкоманда ProcessOff используется для сбора данных профилирования для запуска приложения.

; 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