Compartir a través de

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

  • Artículo

El motor llama al método de devolución de llamada ChangeDebuggeeState cuando realiza o detecta cambios en el destino.

Sintaxis

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

Parámetros

[in] Flags

Especifica el tipo de cambios realizados en el destino. Las marcas pueden tomar uno de los siguientes valores:

Valor Descripción
DEBUG_CDS_ALL Se ha producido un cambio general en el destino. Por ejemplo, el destino se ha ejecutado o el motor acaba de adjuntarlo al destino.
DEBUG_CDS_REGISTERS El registro del procesador para el destino ha cambiado.
DEBUG_CDS_DATA El espacio de datos del destino ha cambiado.

[in] Argument

Proporciona información adicional sobre el cambio en el destino. La interpretación del valor de Argument depende del valor de Flags:

DEBUG_CDS_ALL
El valor de Argument es cero.
DEBUG_CDS_REGISTERS
Si ha cambiado un único registro, el valor de Argument es el índice de ese registro. De lo contrario, el valor de Argument es DEBUG_ANY_ID.
DEBUG_CDS_DATA
El valor de Argument especifica qué espacio de datos se cambió. La tabla siguiente contiene los valores posibles de Argument.
Valor Descripción
DEBUG_DATA_SPACE_VIRTUAL La memoria virtual del destino ha cambiado.
DEBUG_DATA_SPACE_PHYSICAL La memoria física del destino ha cambiado.
DEBUG_DATA_SPACE_CONTROL La memoria de control del destino ha cambiado.
DEBUG_DATA_SPACE_IO Los puertos de E/S del destino han recibido la entrada o salida.
DEBUG_DATA_SPACE_MSR Los registros de Model-Specific (MSR) del destino han cambiado.
DEBUG_DATA_SPACE_BUS_DATA La memoria del bus del destino ha cambiado.
 

Valor devuelto

El motor omite el valor devuelto a menos que indique un error de llamada a procedimiento remoto; en este caso, el cliente, con el que está registrado este objeto IDebugEventCallbacksWide , está deshabilitado.

Comentarios

El motor llama a ChangeDebuggeeState solo si la marca DEBUG_EVENT_CHANGE_DEBUGGEE_STATE está establecida en la máscara devuelta por IDebugEventCallbacksWide::GetInterestMask.

Para obtener más información sobre el control de eventos, consulte Supervisión de eventos. Para obtener información sobre cómo administrar la memoria del destino, incluidos los registros y los espacios de datos, consulte Acceso a memoria. Para obtener información sobre la memoria virtual y física del destino, consulte Memoria virtual y física. Para obtener información sobre la memoria de control del destino, los puertos de E/S, MSR y la memoria de bus, consulte Otros espacios de datos.

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado dbgeng.h (incluir Dbgeng.h)