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

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	Los registros del procesador para el destino han cambiado.
DEBUG_CDS_DATA	El espacio de datos del destino ha cambiado.
DEBUG_CDS_REFRESH	Informe a los clientes de gui para actualizar las ventanas del depurador.

[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.

 

DEBUG_CDS_REFRESH

La tabla siguiente contiene los valores posibles de Argument.

Valor
DEBUG_CDS_REFRESH_EVALUATE
DEBUG_CDS_REFRESH_EXECUTE
DEBUG_CDS_REFRESH_EXECUTECOMMANDFILE
DEBUG_CDS_REFRESH_ADDBREAKPOINT
DEBUG_CDS_REFRESH_REMOVEBREAKPOINT
DEBUG_CDS_REFRESH_WRITEVIRTUAL
DEBUG_CDS_REFRESH_WRITEVIRTUALUNCACHED
DEBUG_CDS_REFRESH_WRITEPHYSICAL
DEBUG_CDS_REFRESH_WRITEPHYSICAL2
DEBUG_CDS_REFRESH_SETVALUE
DEBUG_CDS_REFRESH_SETVALUE2
DEBUG_CDS_REFRESH_SETSCOPE
DEBUG_CDS_REFRESH_SETSCOPEFRAMEBYINDEX
DEBUG_CDS_REFRESH_SETSCOPEFROMJITDEBUGINFO
DEBUG_CDS_REFRESH_SETSCOPEFROMSTOREDEVENT
DEBUG_CDS_REFRESH_INLINESTEP
DEBUG_CDS_REFRESH_INLINESTEP_PSEUDO

 

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 IDebugEventCallbacks , 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 IDebugEventCallbacks::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)