IDebugDataSpaces4::GetOffsetInformation メソッド (dbgeng.h)

GetOffsetInformation メソッドは、プロセスのデータ空間内のアドレスに関する一般的な情報を提供します。

構文

HRESULT GetOffsetInformation(
  [in]            ULONG   Space,
  [in]            ULONG   Which,
  [in]            ULONG64 Offset,
  [out, optional] PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  InfoSize
);

パラメーター

[in] Space

Offset パラメーターを適用するデータ空間を指定します。 使用できる値は 、Which パラメーターによって異なります。

[in] Which

クエリを実行するデータに関する情報を指定します。 これにより、 Space の使用可能な値と 、Buffer で返されるデータの型が決まります。 次のいずれかの値になります。

DEBUG_OFFSINFO_VIRTUAL_SOURCE

ターゲットの仮想メモリのソースを Offset で返 します。 デバッガー エンジンがメモリを読み取る場所です。 スペース はDEBUG_DATA_SPACE_VIRTUALに設定する必要があります。 ULONG が Buffer に返されます。 この ULONG は、次の表に示す値を受け取ることができます。

値	説明
DEBUG_VSOURCE_INVALID	オフセット オフセットは、プロセスの仮想アドレス空間では使用できません。 これは、アドレスが無効であるか、メモリが使用できないことを意味する可能性があります。たとえば、クラッシュ ダンプ ファイルに、プロセスまたはカーネルのすべてのメモリが含まれていない可能性があります。
DEBUG_VSOURCE_DEBUGGEE	Offset オフセットの仮想メモリは、ターゲットによって提供されます。
DEBUG_VSOURCE_MAPPED_IMAGE	デバッガー エンジンは、ローカル イメージ ファイルから オフセット オフセットでターゲットの仮想メモリを読み取ります。 これは、多くの場合、モジュール イメージがダンプ ファイルに含まれず、代わりにデバッガー エンジンによって読み込まれるミニダンプ ファイルの場合です。

[in] Offset

情報が返されるターゲットのデータ空間内のオフセットを指定します。

[out, optional] Buffer

情報を受信するバッファーを指定します。 返されるデータの型は、 Which の値によって異なります。 Buffer が NULL の場合、この情報は返されません。

[in] BufferSize

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

[out, optional] InfoSize

返される情報のサイズをバイト単位で受け取ります。 InfoSize が NULL の場合、この情報は返されません。

戻り値

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

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

要件

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