Dokumentacja: polecenia vcperf

W tym artykule wymieniono i opisano polecenia dostępne w vcperf.exeprogramie oraz sposób ich używania.

Polecenia uruchamiania i zatrzymywania śladów

Ważne

Jeśli nie określisz /noadminparametru , następujące polecenia wymagają uprawnień administracyjnych.

Opcja	Argumenty i opis
/start	[] [/noadmin] [] [/level1 | | /level2/level3]/nocpusampling<sessionName>
	Uruchamia ślad pod daną nazwą sesji. Opcja /noadmin jest uruchamiana vcperf.exe bez uprawnień administratora i ignoruje /nocpusampling tę opcję. Po uruchomieniu narzędzia vcperf bez uprawnień administratora może istnieć więcej niż jedna aktywna sesja na danym komputerze. Opcja /nocpusampling określa , vcperf.exe nie zbiera przykładów procesora CPU. Zapobiega ona użyciu widoku Użycie procesora CPU (próbkowane) w systemie Windows Analizator wydajności, ale sprawia, że zebrane ślady są mniejsze. Opcje /level1, /level2lub /level3 określają, które zdarzenia MSVC mają być zbierane, na rosnącym poziomie informacji. Poziom 3 obejmuje wszystkie zdarzenia. Poziom 2 obejmuje wszystkie zdarzenia z wyjątkiem zdarzeń tworzenia wystąpienia szablonu. Poziom 1 obejmuje wszystkie zdarzenia, z wyjątkiem wystąpień szablonu, funkcji i zdarzeń plików. Jeśli nieokreślone, /level2 jest domyślnie zaznaczone. Gdy vcperf.exe uruchomi ślad, zostanie zwrócony natychmiast. Śledzenie zbiera zdarzenia dla całego systemu dla wszystkich procesów uruchomionych na maszynie. Oznacza to, że nie musisz kompilować projektu w tym samym oknie wiersza polecenia, co używany do uruchamiania vcperf.exe. Możesz na przykład skompilować projekt w programie Visual Studio.
/stop	(1) [/templates] <sessionName> <outputFile.etl> (2) [/templates] <sessionName> /timetrace <outputFile.json>
	Zatrzymuje ślad zidentyfikowany przez daną nazwę sesji. Uruchamia krok przetwarzania końcowego śledzenia w celu wygenerowania pliku określonego <outputFile> przez parametr . Opcja /templates zawiera zdarzenia tworzenia wystąpień szablonu w pliku. (1) Generuje plik wyświetlany w systemie Windows Analizator wydajności (WPA). Plik wyjściowy wymaga .etl rozszerzenia. (2) Generuje plik, który można wyświetlić w przeglądarce śledzenia przeglądarki Microsoft Edge (edge://tracing). Plik wyjściowy wymaga .json rozszerzenia.
/stopnoanalyze	<sessionName> <rawOutputFile.etl>
	Zatrzymuje ślad identyfikowany przez daną nazwę sesji i zapisuje nieprzetworzone dane w określonym pliku wyjściowym. Wynikowy plik nie jest przeznaczony do wyświetlania w usłudze WPA. Krok przetwarzania końcowego związany z poleceniem /stop może czasami być długi. Możesz użyć /stopnoanalyze polecenia , aby opóźnić ten krok przetwarzania końcowego. /analyze Użyj polecenia , gdy wszystko będzie gotowe do utworzenia pliku widocznego w systemie Windows Analizator wydajności lub podglądu śledzenia przeglądarki Microsoft Edge.

Różne polecenia

Opcja	Argumenty i opis
/analyze	(1) [/templates] <rawInputFile.etl> <outputFile.etl> (2) [/templates] <rawInputFile.etl> /timetrace <outputFile.json>
	Akceptuje nieprzetworzonego pliku śledzenia utworzonego /stopnoanalyze przez polecenie . Uruchamia krok przetwarzania końcowego dla tego śladu w celu wygenerowania pliku określonego <outputFile> przez parametr . Opcja /templates zawiera zdarzenia tworzenia wystąpień szablonu w pliku. (1) Generuje plik wyświetlany w systemie Windows Analizator wydajności (WPA). Plik wyjściowy wymaga .etl rozszerzenia. (2) Generuje plik, który można wyświetlić w przeglądarce śledzenia przeglądarki Microsoft Edge (edge://tracing). Plik wyjściowy wymaga .json rozszerzenia.

Zobacz też

Wprowadzenie do szczegółowych informacji o kompilacji języka C++
Samouczek: Podstawy Analizator wydajności systemu Windows
Dokumentacja: Widoki Analizator wydajności systemu Windows
Analizator wydajności systemu Windows