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

El motor llama al método de devolución de llamada ChangeEngineState cuando su estado ha cambiado.

Sintaxis

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

Parámetros

[in] Flags

Especifica un conjunto de bits que indica el tipo de cambios que se produjeron en el estado del motor. Es posible que se establezcan las marcas de bits siguientes:

Valor	Descripción
DEBUG_CES_CURRENT_THREAD	El subproceso actual ha cambiado, lo que implica que el destino actual y el proceso actual también podrían haber cambiado.
DEBUG_CES_EFFECTIVE_PROCESSOR	El procesador efectivo ha cambiado.
DEBUG_CES_BREAKPOINTS	Uno o varios puntos de interrupción han cambiado.
DEBUG_CES_CODE_LEVEL	El nivel de interpretación del código ha cambiado.
DEBUG_CES_EXECUTION_STATUS	El estado de ejecución ha cambiado.
DEBUG_CES_ENGINE_OPTIONS	Las opciones del motor han cambiado.
DEBUG_CES_LOG_FILE	El archivo de registro se ha abierto o cerrado.
DEBUG_CES_RADIX	El radix predeterminado ha cambiado.
DEBUG_CES_EVENT_FILTERS	Los filtros de eventos han cambiado.
DEBUG_CES_PROCESS_OPTIONS	Las opciones de proceso del proceso actual han cambiado.
DEBUG_CES_EXTENSIONS	Los archivos DLL de extensión se han cargado o descargado. (Para obtener más información, vea Cargar archivos DLL de extensión del depurador).
DEBUG_CES_SYSTEMS	Se ha agregado o quitado un destino.
DEBUG_CES_ASSEMBLY_OPTIONS	Las opciones de ensamblado han cambiado.
DEBUG_CES_EXPRESSION_SYNTAX	La sintaxis de expresión predeterminada ha cambiado.
DEBUG_CES_TEXT_REPLACEMENTS	Los reemplazos de texto han cambiado.

[in] Argument

Proporciona información adicional sobre el cambio en el estado del motor. Si se establece más de una marca de bits en el parámetro Flags , no se usa el parámetro Argument . De lo contrario, la interpretación del valor de Argument depende del valor de Flags:

DEBUG_CES_CURRENT_THREAD

El valor de Argument es el identificador de subproceso del motor actual o--si no hay ningún subproceso actual--DEBUG_ANY_ID. Para obtener más información, vea Subprocesos y procesos.

DEBUG_CES_EFFECTIVE_PROCESSOR

El valor de Argument es el tipo del procesador efectivo.

DEBUG_CES_BREAKPOINTS

El valor de Argument es el identificador de punto de interrupción del punto de interrupción que se cambió o,si se cambió más de un punto de interrupción, DEBUG_ANY_ID. Para obtener más información, vea Puntos de interrupción.

DEBUG_CES_CODE_LEVEL

El valor de Argument es el nivel de interpretación del código.

DEBUG_CES_EXECUTION_STATUS

El valor de Argument es el estado de ejecución (como se describe en el tema de DEBUG_STATUS_XXX ) posiblemente combinado con la marca de bits DEBUG_STATUS_INSIDE_WAIT. DEBUG_STATUS_INSIDE_WAIT se establece cuando está pendiente una llamada a WaitForEvent . Para obtener más información, consulte Depuración del modelo de sesión y ejecución.

DEBUG_CES_ENGINE_OPTIONS

El valor de Argument es las opciones del motor.

DEBUG_CES_LOG_FILE

El valor de Argument es TRUE si el archivo de registro se abrió y FALSE si se cerró el archivo de registro.

DEBUG_CES_RADIX

El valor de Argument es el radix predeterminado.

DEBUG_CES_EVENT_FILTERS

El valor de Argument es el índice del filtro de eventos que se cambió o-si se cambió más de un filtro de eventos--DEBUG_ANY_ID.

DEBUG_CES_PROCESS_OPTIONS

El valor de Argument es las opciones de proceso del proceso actual.

DEBUG_CES_EXTENSIONS

El valor de Argument es cero.

DEBUG_CES_SYSTEMS

El valor de Argument es el identificador de destino del destino que se agregó o-si se quitó un destino--DEBUG_ANY_ID.

DEBUG_CES_ASSEMBLE_OPTIONS

El valor de Argument es las opciones de ensamblado.

DEBUG_CES_EXPRESSION_SYNTAX

El valor de Argument es la sintaxis de expresión predeterminada.

DEBUG_CES_TEXT_REPLACEMENTS

El valor de Argument es DEBUG_ANY_ID.

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 se registra este objeto IDebugEventCallbacksWide , está deshabilitado.

Comentarios

El motor llama a este método solo si la marca de DEBUG_EVENT_CHANGE_ENGINE_STATE está establecida en la máscara devuelta por IDebugEventCallbacksWide::GetInterestMask.

Para obtener más información sobre cómo controlar eventos, consulte Supervisión de eventos.

Requisitos

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