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

コンテキストのサイズ (バイト単位) を受け取ります。 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 の