Метод IDebugControl4::GetStoredEventInformation (dbgeng.h)

Метод GetStoredEventInformation извлекает сведения о событии, интересующемом текущем целевом объекте.

Синтаксис

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
);

Параметры

[out] Type

Получает тип хранимого события. Список возможных типов см. в DEBUG_EVENT_XXX.

[out] ProcessId

Получает идентификатор процесса процесса, в котором произошло событие. Если эта информация недоступна, DEBUG_ANY_ID будет возвращена вместо этого.

[out] ThreadId

Получает идентификатор потока потока, в котором произошло последнее событие. Если эта информация недоступна, DEBUG_ANY_ID будет возвращена вместо этого.

[out, optional] Context

Получает контекст потока хранимого события. Тип контекста потока — это структура CONTEXT для эффективного процессора целевого объекта во время события. Буфер контекста должен быть достаточно большим для хранения этой структуры. Если контекстаNULL, эти сведения не возвращаются.

[in] ContextSize

Указывает размер в байтах буфера, который контекст.

[out, optional] ContextUsed

Получает размер в байтах контекста. Если ContextUsedNULL, эти сведения не возвращаются.

[out, optional] ExtraInformation

Получает дополнительные сведения о событии. Содержимое этой дополнительной информации зависит от типа события. Если ExtraInformation значение NULL, эти сведения не возвращаются.

[in] ExtraInformationSize

Задает размер в байтах буфера, который ЭкстраInformation.

[out, optional] ExtraInformationUsed

Получает размер в байтах дополнительных сведений. Если ExtraInformationUsedNULL, эти сведения не возвращаются.

Возвращаемое значение

Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в возвращаемых значений.

Замечания

Многие целевые объекты не имеют интереса.

Если целевой объект — мини-файл в режиме пользователя, генератор файлов дампа может хранить дополнительное событие. Как правило, это событие, которое спровоцировало генератор для сохранения файла дампа.

Дополнительные сведения см. в разделе сведения о событиях.

Требования

См. также

GetLastEventInformation

IDebugControl4