Client_Ptr_Flat

include vmm.inc

Client_Ptr_Flat LinAddr, Segment, Offset
Client_Ptr_Flat LinAddr, Segment, Offset, USES_EAX

Converts the specified segment:offset or selector:offset or segment:offset pair from the client register into a linear address.

• Returns the linear address in the register specified by the LinAddr parameter, if successful. If the specified selector is invalid, the service returns – 1 in the specified register.

LinAddr

32-bit register to receive the linear address.

Segment

Client segment register containing the segment address or selector to convert.

Offset

Client register containing the address offset to convert. If this optional parameter is not given, the macro converts the address using address offset 0. You can specify either a 16-bit or 32-bit general-purpose register. The macro will use the low word or the full 32-bit register, depending on whether the client is in 16-bit or 32-bit mode.

USES_EAX

If the word USES_EAX is appended to the macro call, the macro will use the EAX register as a scratch register. Normally the macro preserves all registers except LinAddr. The macro is slightly more efficient if it is allowed to damage the EAX register.

The Client_Ptr_Flat macro uses the Map_Flat service.

This example converts the address Client_DS:Client_(E)DX, and places the corresponding linear address in the EAX register:

Client_Ptr_Flat eax, DS, DX

See also Map_Flat