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 参数应用到的数据空间。 允许的值取决于 哪个 参数。
[in] Which
指定要查询数据的哪些信息。 这将确定 Space 的可能值以及 Buffer中返回的数据的类型。 可能的值包括:
DEBUG_OFFSINFO_VIRTUAL_SOURCE
返回目标虚拟内存 偏移量的源。 这是调试器引擎从中读取内存的位置。 空间 必须设置为DEBUG_DATA_SPACE_VIRTUAL。 ULONG 返回到 Buffer。 此 ULONG 可以采用下表中列出的值。
价值 | 描述 |
---|---|
DEBUG_VSOURCE_INVALID |
偏移量 偏移量在进程的虚拟地址空间中不可用。
这可能意味着地址无效,或者内存不可用,例如,故障转储文件可能不包含进程或内核的所有内存。 |
DEBUG_VSOURCE_DEBUGGEE | 目标提供 偏移量 偏移量的虚拟内存。 |
DEBUG_VSOURCE_MAPPED_IMAGE | 调试器引擎从本地映像文件读取目标 偏移量 偏移量的目标虚拟内存。 这通常是在转储文件中不包含模块映像的小型转储文件中的情况,而是由调试器引擎加载。 |
[in] Offset
指定目标数据空间中返回信息的偏移量。
[out, optional] Buffer
指定要接收信息的缓冲区。 返回的数据的类型取决于 的值。 如果 缓冲区NULL,则不会返回此信息。
[in] BufferSize
指定 缓冲区 缓冲区的大小(以字节为单位)。
[out, optional] InfoSize
接收返回的信息的大小(以字节为单位)。 如果 InfoSizeNULL,则不会返回此信息。
返回值
此方法还可以返回错误值。 有关详细信息,请参阅 返回值。
返回代码 | 描述 |
---|---|
|
该方法成功。 |
要求
要求 | 价值 |
---|---|
目标平台 | 桌面 |
标头 | dbgeng.h (包括 Dbgeng.h) |