Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Используется в профильной оптимизации для записи всех данных профиля из выполняющейся программы в PGC-файл.
Синтаксис
pgosweep[параметры] imagepgcfile
Параметры
параметры
(Необязательно) Допустимые значения для options:
/?или/help— выводит справочное сообщение.
сбрасывает счетчики до нуля после очистки. Поведение по умолчанию. /pid:nприменяет только указанный PID, где n — номер PID./waitожидает завершения процесса с указанным PID перед сбором данных счетчика./onlyzeroне сохраняет PGC-файл, только нулевые значения счетчиков./pauseприостанавливает сбор данных счетчиков в системе./resumeвозобновляет сбор данных счетчиков в системе./noresetсохраняет счёт в структурах данных среды выполнения.
Изображение
Полный путь к файлу EXE или DLL, созданному с помощью параметра /GENPROFILE, /FASTGENPROFILE или /LTCG:PGINSTRUMENT.
pgcfile
Файл PGC, в который эта команда записывает количество данных.
Замечания
Команда pgosweep работает с программами, созданными с помощью параметра /GENPROFILE или /FASTGENPROFILE либо устаревшего параметра /LTCG:PGINSTRUMENT. Она прерывает выполнение программы и записывает данные профиля в новый PGC-файл. По умолчанию команда сбрасывает счетчики после каждой операции записи. Если указать параметр /noreset, команда будет записывать значения, но не будет сбрасывать их в выполняющейся программе. Этот параметр приведет к дублированию данных, если позже вы извлечете данные профиля.
Альтернативный вариант использования pgosweep — получение данных профиля только для нормального режима работы приложения. Например, можно выполнить команду pgosweep сразу же после запуска приложения и удалить этот файл. Эта команда удаляет данные профиля, связанные с затратами на запуск. После этого можно выполнить pgosweep перед завершением работы приложения. В результате будут собраны данные профиля только с момента, когда пользователь получил возможность взаимодействовать с программой.
При присвоении имени PGC-файлу (с помощью параметра pgcfile) можно использовать стандартный формат, то есть appname!n.pgc, где n — увеличивающееся числовое значение для каждого файла. При использовании такого формата компилятор автоматически находит данные на этапе /LTCG /USEPROFILE или /LTCG:PGO. Если стандартный формат не применяется, необходимо использовать параметр pgomgr для слияния файлов PGC.
Примечание.
Это средство можно запустить только из командной строки разработчика Visual Studio. Его нельзя запустить из системной командной строки или проводника.
Сведения о том, как снять данные профиля из исполняемого файла, см. здесь: PgoAutoSweep.
Пример
В этом примере команда pgosweep записывает текущие данные профиля для myapp.exe в файл myapp!1.pgc.
pgosweep myapp.exe myapp!1.pgc