Método IDebugEventCallbacks::ChangeEngineState (dbgeng.h)

O método de retorno de chamada ChangeEngineState é chamado pelo mecanismo quando seu estado é alterado.

Sintaxe

HRESULT ChangeEngineState(
  [in] ULONG   Flags,
  [in] ULONG64 Argument
);

Parâmetros

[in] Flags

Especifica um conjunto de bits que indica o tipo de alterações que ocorreram no estado do mecanismo. Os seguintes sinalizadores de bits podem ser definidos:

Valor	Descrição
DEBUG_CES_CURRENT_THREAD	O thread atual foi alterado, o que implica que o destino atual e o processo atual também podem ter sido alterados.
DEBUG_CES_EFFECTIVE_PROCESSOR	O processador efetivo foi alterado.
DEBUG_CES_BREAKPOINTS	Um ou mais pontos de interrupção foram alterados .
DEBUG_CES_CODE_LEVEL	O nível de interpretação de código foi alterado.
DEBUG_CES_EXECUTION_STATUS	O status de execução foi alterado.
DEBUG_CES_ENGINE_OPTIONS	As opções do mecanismo foram alteradas.
DEBUG_CES_LOG_FILE	O arquivo de log foi aberto ou fechado.
DEBUG_CES_RADIX	O radix padrão foi alterado.
DEBUG_CES_EVENT_FILTERS	Os filtros de evento foram alterados.
DEBUG_CES_PROCESS_OPTIONS	As opções de processo para o processo atual foram alteradas.
DEBUG_CES_EXTENSIONS	As DLLs de extensão foram carregadas ou descarregadas. (Para obter mais informações, consulte Carregando DLLs de extensão do depurador.)
DEBUG_CES_SYSTEMS	Um destino foi adicionado ou removido.
DEBUG_CES_ASSEMBLY_OPTIONS	As opções de montagem foram alteradas.
DEBUG_CES_EXPRESSION_SYNTAX	A sintaxe de expressão padrão foi alterada.
DEBUG_CES_TEXT_REPLACEMENTS	As substituições de texto foram alteradas.

[in] Argument

Fornece informações adicionais sobre a alteração no estado do mecanismo. Se mais de um sinalizador de bit for definido no parâmetro Flags , o parâmetro Argument não será usado. Caso contrário, a interpretação do valor de Argument depende do valor de Flags:

DEBUG_CES_CURRENT_THREAD

O valor de Argument é a ID do thread do mecanismo atual ou, se não houver thread atual, DEBUG_ANY_ID. Para obter mais informações, consulte Threads and Processes.

DEBUG_CES_EFFECTIVE_PROCESSOR

O valor de Argument é o tipo do processador efetivo.

DEBUG_CES_BREAKPOINTS

O valor de Argument é a ID do ponto de interrupção do ponto de interrupção que foi alterado ou, se mais de um ponto de interrupção foi alterado, DEBUG_ANY_ID. Para obter mais informações, confira Pontos de interrupção.

DEBUG_CES_CODE_LEVEL

O valor de Argument é o nível de interpretação de código.

DEBUG_CES_EXECUTION_STATUS

O valor de Argument é o status de execução (conforme descrito no tópico DEBUG_STATUS_XXX) possivelmente combinado com o sinalizador de bit DEBUG_STATUS_INSIDE_WAIT. DEBUG_STATUS_INSIDE_WAIT é definido quando uma chamada WaitForEvent está pendente. Para obter mais informações, confira Modelo de execução e sessão de depuração.

DEBUG_CES_ENGINE_OPTIONS

O valor de Argument é as opções do mecanismo.

DEBUG_CES_LOG_FILE

O valor de Argument será TRUE se o arquivo de log tiver sido aberto e FALSE se o arquivo de log tiver sido fechado.

DEBUG_CES_RADIX

O valor de Argument é o radix padrão.

DEBUG_CES_EVENT_FILTERS

O valor de Argument é o índice do filtro de evento que foi alterado ou, se mais de um filtro de evento foi alterado, DEBUG_ANY_ID.

DEBUG_CES_PROCESS_OPTIONS

O valor de Argument é as opções de processo para o processo atual.

DEBUG_CES_EXTENSIONS

O valor de Argument é zero.

DEBUG_CES_SYSTEMS

O valor de Argument é a ID de destino do destino que foi adicionado ou, se um destino foi removido, DEBUG_ANY_ID.

DEBUG_CES_ASSEMBLE_OPTIONS

O valor de Argument são as opções de montagem.

DEBUG_CES_EXPRESSION_SYNTAX

O valor de Argument é a sintaxe de expressão padrão.

DEBUG_CES_TEXT_REPLACEMENTS

O valor de Argument é DEBUG_ANY_ID.

Retornar valor

O valor retornado é ignorado pelo mecanismo, a menos que indique um erro de chamada de procedimento remoto; nesse caso, o cliente, com o qual esse objeto IDebugEventCallbacks está registrado, está desabilitado.

Comentários

Esse método só será chamado pelo mecanismo se o sinalizador DEBUG_EVENT_CHANGE_ENGINE_STATE for definido na máscara retornada por IDebugEventCallbacks::GetInterestMask.

Para obter mais informações sobre como lidar com eventos, consulte Eventos de monitoramento.

Requisitos

Requisito	Valor
Plataforma de Destino	Área de Trabalho
Cabeçalho	dbgeng.h (inclua Dbgeng.h)