StopProfile

Článek
03/04/2013

StopProfile Funkce nastaví čítač na 0 (vypnuto) na zadanou úroveň profilování.

PROFILE_COMMAND_STATUS PROFILERAPI StopProfile(
                       PROFILE_CONTROL_LEVEL Level, 
                       unsigned int dwId);

Parametry

Level

Označuje úroveň profil výkonu, které lze použít sběru údajů.Následující PROFILE_CONTROL_LEVEL výčtu lze použít k označení jedné ze tří úrovní výkonu, které lze použít sběr dat:

Čítač výčtu	Description
PROFILE_GLOBALLEVEL	Globální nastavení úrovně se týká všech procesů a podprocesů v Profilování spustit.
PROFILE_PROCESSLEVEL	Nastavení úrovně procesu ovlivnit všechny podprocesy, které jsou součástí určený proces.
PROFILE_THREADLEVEL	Profilování nastavení úrovně podprocesu ovlivňuje Zadaný podproces.

dwId

Proces nebo podproces identifikátor generovaný systémem.

Hodnota/Návratová hodnota vlastnosti

Funkce označuje úspěch nebo neúspěch pomocí PROFILE_COMMAND_STATUS výčtu.Vrácená hodnota může být jeden z následujících:

Čítač výčtu	Description
PROFILE_ERROR_ID_NOEXIST	Profilování ID prvku neexistuje.
PROFILE_ERROR_LEVEL_NOEXIST	Profilování určené úrovni neexistuje.
PROFILE_ERROR_MODE_NEVER	Profilování režim byl nastaven nikdy byla volána funkce.
PROFILE_ERROR_NOT_YET_IMPLEMENTED	Profilování volání funkce profilování úroveň a kombinaci volání a úroveň není dosud implementována.
PROFILE_OK	Volání bylo úspěšné.

Poznámky

StartProfile a StopProfile řízení stavu spuštění a zastavení pro profilování úroveň.Spuštění a zastavení výchozí hodnota je 1.Lze změnit počáteční hodnotu v registru.Každé volání StartProfile nastaví spuštění a zastavení 1; každé volání StopProfile nastaví na hodnotu 0.

Při spuštění a zastavení je větší než 0, je pro úroveň stavu spuštění a zastavení ON.Pokud je menší nebo roven 0, spuštění a zastavení je vypnuto.

Při spuštění a zastavení státu a státu režim spánku/obnovení obě, je stav profilování pro úroveň ON.Pro podproces je profilován, globální, proces a podproces úrovně státy podprocesu, musí být na.

Ekvivalent v rozhraní .NET Framework

Microsoft.VisualStudio.Profiler.dll

Informace o funkci

Záhlaví: Deklarované v VSPerf.h

Import knihovny: VSPerf.lib

Příklad

Následující příklad ukazuje metodu StopProfile.Příklad předpokládá, zda nebyla provedena pro stejné podprocesu nebo procesu, které jsou označeny volání metody StartProfile PROFILE_CURRENTID.

void ExerciseStopProfile()
{
    // StartProfile and StopProfile control the 
    // Start/Stop state for the profiling level. 
    // The default initial value of Start/Stop is 1. 
    // The initial value can be changed in the registry. 
    // Each call to StartProfile sets Start/Stop to 1; 
    // each call to StopProfile sets it to 0. 

    // Variables used to print output.
    HRESULT hResult;
    TCHAR tchBuffer[256];

    // Declare enumeration to hold result of call
    // to StopProfile.
    PROFILE_COMMAND_STATUS profileResult;

    profileResult = StopProfile(
        PROFILE_THREADLEVEL,
        PROFILE_CURRENTID);

    // Format and print result.
    LPCTSTR pszFormat = TEXT("%s %d.\0");
    TCHAR* pszTxt = TEXT("StopProfile returned");
    hResult = StringCchPrintf(tchBuffer, 256, pszFormat, 
        pszTxt, profileResult);

#ifdef DEBUG
    OutputDebugString(tchBuffer);
#endif
}

Viz také

Další zdroje

Visual Studio Profiler API Reference (nativní)

Sdílet prostřednictvím