Edit

Share via

IDebugDataSpaces4::GetNextDifferentlyValidOffsetVirtual method (dbgeng.h)

  • Article

The GetNextDifferentlyValidOffsetVirtual method returns the offset of the next address whose validity might be different from the validity of the specified address.

Syntax

HRESULT GetNextDifferentlyValidOffsetVirtual(
  [in]  ULONG64  Offset,
  [out] PULONG64 NextOffset
);

Parameters

[in] Offset

Specifies a start address. The address returned in NextOffset will be the next address whose validity might be defined differently from this one.

[out] NextOffset

Receives the address of the next address whose validity might be defined differently from the address in Offset.

Return value

This method can also return error values. See Return Values for more details.

Return code Description
S_OK
 The method was successful.

Remarks

The size of regions of validity depends on the target. For example, in live user-mode debugging sessions, where virtual address validity changes from page to page, NextOffset will receive the address of the next page. In user-mode dump files the validity can change from byte to byte.

Requirements

Requirement Value
Target Platform Desktop
Header dbgeng.h (include Dbgeng.h)

See also

GetValidRegionVirtual

IDebugDataSpaces4