Método IDebugControl4::GetStoredEventInformation (dbgeng.h)

El método GetStoredEventInformation recupera información sobre un evento de interés disponible en el destino actual.

Sintaxis

HRESULT GetStoredEventInformation(
  [out]           PULONG Type,
  [out]           PULONG ProcessId,
  [out]           PULONG ThreadId,
  [out, optional] PVOID  Context,
  [in]            ULONG  ContextSize,
  [out, optional] PULONG ContextUsed,
  [out, optional] PVOID  ExtraInformation,
  [in]            ULONG  ExtraInformationSize,
  [out, optional] PULONG ExtraInformationUsed
);

Parámetros

[out] Type

Recibe el tipo del evento almacenado. Para obtener una lista de los tipos posibles, consulte DEBUG_EVENT_XXX.

[out] ProcessId

Recibe el identificador de proceso del proceso en el que se produjo el evento. Si esta información no está disponible, se devolverá DEBUG_ANY_ID en su lugar.

[out] ThreadId

Recibe el identificador de subproceso del subproceso en el que se produjo el último evento. Si esta información no está disponible, se devolverá DEBUG_ANY_ID en su lugar.

[out, optional] Context

Recibe el contexto del subproceso del evento almacenado. El tipo del contexto del subproceso es la estructura CONTEXT del procesador efectivo del destino en el momento del evento. El búfer de contexto debe ser lo suficientemente grande como para contener esta estructura. Si Context es NULL, esta información no se devuelve.

[in] ContextSize

Especifica el tamaño, en bytes, del búfer que especifica Context .

[out, optional] ContextUsed

Recibe el tamaño en bytes del contexto. Si ContextUsed es NULL, esta información no se devuelve.

[out, optional] ExtraInformation

Recibe información adicional sobre el evento. El contenido de esta información adicional depende del tipo del evento. Si ExtraInformation es NULL, esta información no se devuelve.

[in] ExtraInformationSize

Especifica el tamaño, en bytes, del búfer que especifica ExtraInformation .

[out, optional] ExtraInformationUsed

Recibe el tamaño en bytes de información adicional. Si ExtraInformationUsed es NULL, esta información no se devuelve.

Valor devuelto

Este método también puede devolver valores de error. Consulte Valores devueltos para obtener más detalles.

Código devuelto	Descripción
S_OK	Método realizado correctamente.

Comentarios

Muchos destinos no tienen un evento de interés.

Si el destino es un archivo minivolcado de modo de usuario, el generador de archivos de volcado puede almacenar un evento adicional. Normalmente, este es el evento que provocó que el generador guarde el archivo de volcado.

Para obtener más información, vea el tema Información de eventos.

Requisitos

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

Consulte también

GetLastEventInformation

IDebugControl4