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 の場合、この情報は返されません。
戻り値
このメソッドは、エラー値を返すこともできます。 詳細については、「 戻り値 」を参照してください。
リターン コード | 説明 |
---|---|
|
メソッドは正常に実行されました。 |
要件
要件 | 値 |
---|---|
対象プラットフォーム | デスクトップ |
Header | dbgeng.h (Dbgeng.h を含む) |