Método IDebugEventCallbacks::ChangeEngineState (dbgeng.h)
El motor llama al ChangeEngineState método de devolución de llamada 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 para el proceso actual han cambiado. |
| DEBUG_CES_EXTENSIONS | Los archivos DLL de extensión se han cargado o descargado. (Para obtener más información, consulte carga de 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 del 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 Argumento es el estado de ejecución (como se describe en el tema 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 WaitForEvent. Para obtener más información, vea depuración de sesión y modelo de ejecución.
DEBUG_CES_ENGINE_OPTIONS
El valor de Argument es las opciones del motor.
DEBUG_CES_LOG_FILE
El valor de Argumento es TRUE si se abrió el archivo de registro 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--if 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 argumento es cero.
DEBUG_CES_SYSTEMS
El valor de Argumento 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 Argumento 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 argumento 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 este IDebugEventCallbacks objeto está registrado, está deshabilitado.
Observaciones
El motor solo llama a este método si la marca DEBUG_EVENT_CHANGE_ENGINE_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.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | dbgeng.h (include Dbgeng.h) |