Поделиться через

Метод 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 для эффективного процессора целевого объекта во время события. Буфер контекста должен быть достаточно большим, чтобы вместить эту структуру. Если аргумент Context имеет значение NULL, эта информация не возвращается.

[in] ContextSize

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

[out, optional] ContextUsed

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

[out, optional] ExtraInformation

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

[in] ExtraInformationSize

Указывает размер буфера, указанного в ExtraInformation ( в байтах).

[out, optional] ExtraInformationUsed

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

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

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

Код возврата Описание
S_OK
 Метод выполнен успешно.

Комментарии

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

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

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

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть dbgeng.h (включая Dbgeng.h, Ntddk.h)

См. также раздел

GetLastEventInformation

IDebugControl4