Método IDebugEventCallbacksWide::ChangeDebuggeeState (dbgeng.h)

Artigo
02/06/2025

O método de retorno de chamada ChangeDebuggeeState é chamado pelo mecanismo quando ele faz ou detecta alterações no destino.

Sintaxe

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

Parâmetros

[in] Flags

Especifica o tipo de alterações feitas no destino. Flags pode ter um dos seguintes valores:

Valor	Descrição
DEBUG_CDS_ALL	Ocorreu uma alteração geral no destino. Por exemplo, o destino foi executado ou o mecanismo acabou de ser anexado ao destino.
DEBUG_CDS_REGISTERS	O registro do processador para o destino foi alterado.
DEBUG_CDS_DATA	O espaço de dados do destino foi alterado.

[in] Argument

Fornece informações adicionais sobre a alteração no destino. A interpretação do valor do de Argumento depende do valor de sinalizadores de :

DEBUG_CDS_ALL

O valor de Argument é zero.

DEBUG_CDS_REGISTERS

Se um único registro tiver sido alterado, o valor de Argument será o índice desse registro. Caso contrário, o valor de Argument é DEBUG_ANY_ID.

DEBUG_CDS_DATA

O valor de Argument especifica qual espaço de dados foi alterado. A tabela a seguir contém os valores possíveis de Argument.

Valor	Descrição
DEBUG_DATA_SPACE_VIRTUAL	A memória virtual do destino foi alterada.
DEBUG_DATA_SPACE_PHYSICAL	A memória física do destino foi alterada.
DEBUG_DATA_SPACE_CONTROL	A memória de controle do destino foi alterada.
DEBUG_DATA_SPACE_IO	As portas de E/S do destino receberam entrada ou saída.
DEBUG_DATA_SPACE_MSR	Os MSRs (Registros de Model-Specific) do destino foram alterados.
DEBUG_DATA_SPACE_BUS_DATA	A memória do barramento do destino foi alterada.

Valor de retorno

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

Observações

O mecanismo chamará ChangeDebuggeeState somente se o sinalizador de DEBUG_EVENT_CHANGE_DEBUGGEE_STATE estiver definido na máscara retornada por IDebugEventCallbacksWide::GetInterestMask.

Para obter mais informações sobre como lidar com eventos, consulte Eventos de Monitoramento. Para obter informações sobre como gerenciar a memória do destino, incluindo registros e espaços de dados, consulte de Acesso à Memória. Para obter informações sobre a memória virtual e física do destino, consulte de Memória Virtual e Física. Para obter informações sobre memória de controle do destino, portas de E/S, MSR e memória do barramento, consulte Outros Espaços de Dados.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	dbgeng.h (inclua Dbgeng.h)

Compartilhar via