StopProfile

Artigo
08/25/2010

The StopProfile função define o contador como 0 (desativado) para o nível de criação de perfil especificado.

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

Parâmetros

Level

Indica o nível de analisar ao qual desempenho coleta de dados podem ser aplicadas.A seguir PROFILE_CONTROL_LEVEL enumeradores podem ser usados para indicar um dos três níveis de quais dados de desempenho coleção podem ser aplicadas:

Enumerador	Descrição
PROFILE_GLOBALLEVEL	Configuração de nível global afeta todos os processos e threads no perfil executar.
PROFILE_PROCESSLEVEL	Configuração do nível de processo afeta todos os segmentos que fazem parte do processo especificado.
PROFILE_THREADLEVEL	Definindo o perfil de configuração de nível de thread afeta o segmento especificado.

dwId

O identificador de processo ou segmento gerado pelo sistema.

Valor de Propriedade/Valor Retornado

A função indica sucesso ou fracasso usando PROFILE_COMMAND_STATUS enumeração.O valor retornado pode ser uma das seguintes opções:

Enumerador	Descrição
PROFILE_ERROR_ID_NOEXIST	A ID de elemento de criação de perfil não existe.
PROFILE_ERROR_LEVEL_NOEXIST	A criação de perfil especificado não existe.
PROFILE_ERROR_MODE_NEVER	O modo de criação de perfil foi conjunto nunca quando a função foi chamado.
PROFILE_ERROR_NOT_YET_IMPLEMENTED	A criação de perfil telefonar de função, criação de perfil nível ou combinação de nível de telefonar e ainda não está implementada.
PROFILE_OK	A telefonar foi bem-sucedida.

Comentários

StartProfile e StopProfile controle o estado Start/Stop para o nível de criação de perfil.O valor padrão de iniciar/parar é 1.O valor inicial pode ser alterado no registro.Cada telefonar para StartProfile define Start/Stop como 1; cada telefonar para StopProfile define como 0.

Quando iniciar/parar é maior que 0, o estado Start/Stop para o nível é ON.Quando for menor ou igual a 0, o estado Start/Stop é desativada.

Quando o estado Start/Stop e o estado suspender ou retomar são, o estado de perfil para o nível é ON.Para um segmento a ser perfilado, global, processo, e nível estados da thread para o segmento devem ser ativado.

Equivalente do NET Framework

Microsoft.VisualStudio.criador de perfil.dll

Informações de função

Cabeçalho: Declarado em VSPerf.h

Biblioteca de importação: VSPerf.lib

Exemplo

O exemplo a seguir ilustra o método StopProfile.O exemplo supõe que uma telefonar ao método StartProfile foi feita para o mesmo thread ou processo identificado por 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
}

Consulte também

Outros recursos

(Nativa) de referência do API criador de perfil do Visual Studio

Compartilhar via