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 posibles tipos, 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 de 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, no se devuelve esta información.

[in] ContextSize

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

[out, optional] ContextUsed

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

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

[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 información.

Código devuelto	Descripción
S_OK	El método se realizó correctamente.

Observaciones

Muchos destinos no tienen un evento de interés.

Si el destino es un archivo minidump en modo de usuario, el generador de archivos de volcado puede almacenar un evento adicional. Normalmente, este es el evento que provocó al generador para guardar el archivo de volcado.

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

Requisitos

Requisito	Valor
de la plataforma de destino de	Escritorio
encabezado de	dbgeng.h (include Dbgeng.h, Ntddk.h)

Consulte también

GetLastEventInformation

IDebugControl4