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

接收事件发生的进程的进程 ID。 如果此信息不可用,将改为返回DEBUG_ANY_ID。

[out] ThreadId

接收发生最后一个事件的线程的线程 ID。 如果此信息不可用,将改为返回DEBUG_ANY_ID。

[out, optional] Context

接收存储事件的 线程上下文 。 线程上下文的类型是事件发生时目标有效处理器的 CONTEXT 结构。 上下文缓冲区必须足够大才能保存此结构。 如果 上下文NULL,则不会返回此信息。

[in] ContextSize

指定 上下文 指定的缓冲区的大小(以字节为单位)。

[out, optional] ContextUsed

接收上下文的大小(以字节为单位)。 如果 ContextUsedNULL,则不会返回此信息。

[out, optional] ExtraInformation

接收有关事件的额外信息。 此额外信息的内容取决于事件的类型。 如果 ExtraInformationNULL,则不会返回此信息。

[in] ExtraInformationSize

指定 ExtraInformation 指定的缓冲区的大小(以字节为单位)。

[out, optional] ExtraInformationUsed

接收额外信息的大小(以字节为单位)。 如果 ExtraInformationUsedNULL,则不会返回此信息。

返回值

此方法也可能返回错误值。 有关更多详细信息,请参阅 返回值

返回代码 说明
S_OK
该方法成功。

备注

许多目标没有感兴趣的事件。

如果目标是用户模式小型转储文件,转储文件生成器可能会存储其他事件。 通常,这是引发生成器保存转储文件的事件。

有关详细信息,请参阅主题 事件信息

要求

   
目标平台 桌面
Header dbgeng.h (包括 Dbgeng.h、Ntddk.h)

另请参阅

GetLastEventInformation

IDebugControl4