共用方式為

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 緩衝區必須夠大，才能保存這個結構。 如果 ContextNULL，則不會傳回此資訊。

[in] ContextSize

指定context 所指定 緩衝區的大小，以位元組為單位。

[out, optional] ContextUsed

接收以位元組為單位的內容大小。 如果 ContextUsedNULL，則不會傳回此資訊。

[out, optional] ExtraInformation

接收事件的額外資訊。 此額外資訊的內容取決於事件的類型。 如果 ExtraInformationNULL，則不會傳回此資訊。

[in] ExtraInformationSize

指定 ExtraInformation 指定之緩衝區的大小，以位元組為單位。

[out, optional] ExtraInformationUsed

接收額外資訊的位元組大小。 如果 ExtraInformationUsedNULL，則不會傳回此資訊。

傳回值

這個方法也可能傳回錯誤值。 如需詳細資訊，請參閱 傳回值。

傳回碼 描述
S_OK
 方法成功。

言論

許多目標沒有感興趣的事件。

如果目標是使用者模式迷你傾印檔案，傾印檔案產生器可能會儲存額外的事件。 一般而言，這是引發產生器來儲存傾印檔案的事件。

如需詳細資訊，請參閱 事件資訊主題。

要求

要求 價值
目標平臺 桌面
標頭 dbgeng.h （include Dbgeng.h， Ntddk.h）

另請參閱

GetLastEventInformation

IDebugControl4