次の方法で共有

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 構造体です。 コンテキスト バッファーは、この構造体を保持するのに十分な大きさである必要があります。 Context が NULL の場合、この情報は返されません。

[in] ContextSize

Context が指定するバッファーのサイズをバイト単位で指定します。

[out, optional] ContextUsed

コンテキストのサイズをバイト単位で受け取ります。 ContextUsed が NULL の場合、この情報は返されません。

[out, optional] ExtraInformation

イベントに関する追加情報を受信します。 この追加情報の内容は、イベントの種類によって異なります。 ExtraInformation が NULL の場合、この情報は返されません。

[in] ExtraInformationSize

ExtraInformation で指定されるバッファーのサイズをバイト単位で指定します。

[out, optional] ExtraInformationUsed

追加情報のサイズ (バイト単位) を受け取ります。 ExtraInformationUsed が NULL の場合、この情報は返されません。

戻り値

このメソッドは、エラー値を返す場合もあります。 詳細については、「 戻り値 」を参照してください。

リターン コード 説明
S_OK
 メソッドは正常に実行されました。

注釈

多くのターゲットには関心のあるイベントはありません。

ターゲットがユーザー モードのミニダンプ ファイルの場合、ダンプ ファイル ジェネレーターによって追加のイベントが格納される場合があります。 通常、これは、ジェネレーターがダンプ ファイルを保存することを誘発したイベントです。

詳細については、 トピック「イベント情報」を参照してください。

要件

要件 値
対象プラットフォーム デスクトップ
Header dbgeng.h (Dbgeng.h、Ntddk.h を含む)

こちらもご覧ください

GetLastEventInformation

IDebugControl4