Método IDebugEventCallbacks::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, 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 al 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 Argument 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 hay una llamada WaitForEvent pendiente. 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 Argument 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 --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--if 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 está registrado este objeto IDebugEventCallbacks , está deshabilitado.
Comentarios
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 | Value |
|---|---|
| Plataforma de destino | Escritorio |
| Encabezado | dbgeng.h (incluir Dbgeng.h) |