SuspendProfile

Artigo
08/25/2010

The SuspendProfile método incrementa o contador suspender ou retomar o nível de criação de perfil especificado.

PROFILE_COMMAND_STATUS PROFILERAPI SuspendProfile(
                       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

O valor inicial do contador suspender ou retomar é 0.Cada telefonar para SuspendProfile adiciona 1 à contagem de suspender ou retomar; cada telefonar para ResumeProfile subtrai 1.

Quando a contagem de suspender ou retomar for maior que 0, o estado suspender ou retomar do nível é desativada.Quando a contagem é menor ou igual a 0, o estado suspender ou retomar é ON.

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 thread indica para o segmento devem estar 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 SuspendProfile.Este exemplo assume que uma telefonar anterior ao StartProfile foi feita para o processo ou thread identificado por PROFILE_CURRENTID.

void ExerciseSuspendProfile()
{
    // The initial value of the Suspend/Resume counter is 0.
    // Each call to SuspendProfile adds 1 to the
    // Suspend/Resume count; each call
    // to ResumeProfile subtracts 1.
            
    // Variables used to print output
    HRESULT hResult;
    TCHAR tchBuffer[256];

    // Declare enumeration to hold result of call
    // to SuspendProfile
    PROFILE_COMMAND_STATUS profileResult;

    profileResult = SuspendProfile(
        PROFILE_GLOBALLEVEL,
        PROFILE_CURRENTID);

    // Format and print result.
    LPCTSTR pszFormat = TEXT("%s %d.\0");
    TCHAR* pszTxt = TEXT("SuspendProfile 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