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 可以採用下表所列的值。

Description
DEBUG_VSOURCE_INVALID 進程虛擬位址空間中無法使用 位移位移

這可能表示位址無效,或記憶體無法使用 -- 例如,損毀傾印檔案可能不包含進程或核心的所有記憶體。

DEBUG_VSOURCE_DEBUGGEE 位移位移的虛擬記憶體是由目標所提供。
DEBUG_VSOURCE_MAPPED_IMAGE 調試程式引擎會從本機映像檔的 Offset 位移 讀取目標的虛擬記憶體。 這通常是在迷你傾印檔案中,模組映像不包含在傾印檔案中,而是由調試程式引擎載入。

[in] Offset

指定目標數據空間中傳回資訊的位移。

[out, optional] Buffer

指定要接收信息的緩衝區。 傳回的數據型別取決於 [哪一個] 的值。 如果 BufferNULL,則不會傳回這項資訊。

[in] BufferSize

指定 緩衝區 緩衝區的大小,以位元組為單位。

[out, optional] InfoSize

接收傳回之資訊的大小,以位元組為單位。 如果 InfoSizeNULL,則不會傳回此資訊。

傳回值

這個方法也可以傳回錯誤值。 如需詳細資訊,請參閱 傳回值

傳回碼 描述
S_OK
此方法成功。

規格需求

需求
目標平台 桌面
標頭 dbgeng.h (包含 Dbgeng.h)