GetNextDifferentlyValidOffsetVirtual

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

HRESULT
  IDebugDataSpaces4::GetNextDifferentlyValidOffsetVirtual(
    IN ULONG64  Offset,
    OUT PULONG64  NextOffset
    );

Parameters

Offset

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

NextOffset

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

Return Value

S_OK

The method was successful.

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

Interface Version

GetNextDifferentlyValidOffsetVirtual is available in IDebugDataSpaces4 and later versions.

Comments

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

Headers: Defined in Dbgeng.h. Include Dbgeng.h.

See Also

GetValidRegionVirtual