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
情報を受信するバッファーを指定します。 返されるデータの型は、どの の値によって異なります。 バッファー が NULL 場合、この情報は返されません。
[in] BufferSize
バッファー バッファーのサイズをバイト単位で指定します。
[out, optional] InfoSize
返される情報のサイズをバイト単位で受け取ります。 InfoSize が NULL 場合、この情報は返されません。
戻り値
このメソッドは、エラー値を返すこともできます。 詳細については 戻り値の を参照してください。
| リターン コード | 形容 |
|---|---|
|
メソッドが成功しました。 |
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | dbgeng.h (Dbgeng.h を含む) |