Microsoft KB Archive/115080

{|
 * width="100%"|

HOWTO: Convert a Linear Address to a Flat Offset on Win32s

 * }

Q115080

-

The information in this article applies to:


 * Microsoft Win32s versions 1.1, 1.15, 1.2, 1.3, 1.3c

-

SUMMARY
Win32s flat code and data selectors are not zero-based. Linear addresses retrieved through a VxD can be used in a Win32-based application running under Win32s, after one small change is made.

In addition, there are two Universal Thunk APIs that are used to convert segmented addresses to flat addresses and vice versa.

Linear Address to Flat Address
Win32s does not base linear addresses at 0, so that exceptions will be generated when null pointers are dereferenced. Therefore, an access violation occurs when:


 * 1) a 16-bit DLL calls a VxD to retrieve a linear address (the VxD got the address by translating a physical address to a linear address) through DPMI function 0800h (map physical to linear).
 * 2) the 16-bit DLL returns the address to a Win32-based application through the Universal Thunk.
 * 3) the Win32-based application uses this linear address.

In order to convert a linear address (based at 0) to a flat offset, add the base to the linear address. To do this, get the offset through GetThreadSelectorEntry with the DS or CS and then subtract that base from the linear address that was returned by the VxD.

Segmented Address to Flat Address
The following Win32s Universal Thunk APIs are used for address translation:


 * UTSelectorOffsetToLinear (segmented address to flat address)
 * UTLinearToSelectorOffset (flat address to segmented address)

NOTE: In the nested function call

  UTLinearToSelectorOffset( UTSelectorOffsetToLinear( x ) ); where x is a segmented address, you may not necessarily get the original value of x back. It is by design that the sel:off pair may be different. If the memory was allocated by a 16-bit application, Win32s does not have x in its LinearAddress->selector translation tables. Therefore, when UTLinearToSelectorOffset is called, new selectors are created.

Additional query words: gpf gp-fault

Keywords : kbprogramming kbOSWin32s

Issue type : kbhowto

Technology : kbWin32sSearch kbWin32s110 kbWin32s115 kbWin32s120 kbWin32s130 kbWin32s130c