DevHelp VMGlobalToProcess

This service maps an address in the system region of the global address space into an address in the address space of the current process.

Syntax

C

USHORT APIENTRY DevHelp_VMGlobalToProcess( ULONG Flags,
                                           LIN   LinearAddr,
                                           ULONG Length,
                                           PLIN  ProcessLinearAddr)

Assembler

MOV   EBX,LinearAddress     ; Linear Address in global address space
MOV   ECX,Length            ; Length (in bytes) of the memory object to be mapped
MOV   EAX,ActionFlags       ; Actions to perform on user region
                            ; If bit 0 (0001B) is set, the process context is
                            ;    mapped for read/write access to the object.  If
                            ;    this bit is clear, then read only permission is
                            ;    given (Note:  Some hardware may not support read
                            ;    only mapping).
                            ; If bit 1 (0010B) is set, 16-bit selectors are
                            ;    allocated to map the 32-bit region at 64KB
                            ;    boundaries similar to DosAllocHuge.
                            ; If bit 2 (0100B) is set, the mapping is tracked for
                            ;    validation and invalidation of screen buffers.
                            ; If bit 3 (1000B) is set, the memory is allocated on
                            ;    a 4MB boundary which improves performance on the
                            ;    screen group validation/invalidation.  This also
                            ;    reserves the entire 4MB region starting at the
                            ;    4MB boundary.
                            ; All other bits must be clear.

MOV   DL,DevHlp_VMGlobalToProcess

CALL  [Device_Help]

Parameters

C

Flags (ULONG)

Actions to perform on user region:

                        VMDHGP_WRITE - If bit 0 (0001B) is set, the process
                          context is mapped for read/write access to the
                          object. If this bit is clear, then read only
                          permission is given.

                        VMDHGP_SELMAP - If bit 1 (0010B) is set, 16-bit
                          selectors are allocated to map the 32-bit region
                          at 64KB boundaries similar to DosAllocHuge.

                        VMDGP_SGSCONTROL - If bit 2 (0100B) is set,
                          the mapping is tracked for validation and
                          invalidation of screen buffers.

                        VMDHGP_4MEG - If bit 3 (1000B) is set, the memory
                          is allocated on a 4MB boundary which improves
                          performance on the screen group
                          validation/invalidation. This also reserves
                          the entire 4MB region starting at the 4MB
                          boundary.

                       All other bits must be clear.

LinearAddr (LIN)

Linear address in global address space.

Length (ULONG)

Length in bytes of memory object to be mapped.

ProcessLinearAddr (PLIN)

Linear address within process' address space to be returned.

Assembler

MOV   EBX,LinearAddress     ; Linear Address in global address space
MOV   ECX,Length            ; Length (in bytes) of the memory object to be mapped
MOV   EAX,ActionFlags       ; Actions to perform on user region
                            ; If bit 0 (0001B) is set, the process context is
                            ;    mapped for read/write access to the object.  If
                            ;    this bit is clear, then read only permission is
                            ;    given (Note:  Some hardware may not support read
                            ;    only mapping).
                            ; If bit 1 (0010B) is set, 16-bit selectors are
                            ;    allocated to map the 32-bit region at 64KB
                            ;    boundaries similar to DosAllocHuge.
                            ; If bit 2 (0100B) is set, the mapping is tracked for
                            ;    validation and invalidation of screen buffers.
                            ; If bit 3 (1000B) is set, the memory is allocated on
                            ;    a 4MB boundary which improves performance on the
                            ;    screen group validation/invalidation.  This also
                            ;    reserves the entire 4MB region starting at the
                            ;    4MB boundary.
                            ; All other bits must be clear.

Return Code

C

Success Indicator: 0 if conversion performed - returns ProcessLinearAddr.

Possible errors: Carry flag set if conversion not performed.

Assembler

   'C' Clear if conversion performed.
       EAX = Linear address within process's address space.

   'C' Set if conversion not performed.
       EAX = Error code.

Remarks

The mapping created by this function must be released with VMFree. The address range must not cross object boundaries. The address space used in this service is of the current process. In the following figure, VMGlobalToProcess maps the memory allocated with VMAlloc into Process A's private address space.

The following figure shows Mapping Performed by VMGlobalToProcess.

           Before                               After
 ┌───────────────────────┐ 4 Gigabytes ┌───────────────────────┐
 │                       │             │                       │
 │     System Region     │             │     System Region     │
 │                       │             │                       │
 ├───────────────────────┤             ├───────────────────────┤
 │       Object A        │             │       Object A        │
 ├───────────────────────┤             ├───────────────────────┤
 │                       │             │                       │
 ├───────┬───────┬───────┤             ├───────┬───────┬───────┤
 │       │       │       │             │       │       │       │
 │Process│Process│Process│             │Process│Process│Process│
 │   A   │   B   │   C   │             │   A   │   B   │   C   │
 │Address│Address│Address│             │Address│Address│Address│
 │ Space │ Space │ Space │             │ Space │ Space │ Space │
 │       │       │       │             ├───────┤       │       │
 │       │       │       │             │ Obj A │       │       │
 │       │       │       │             ├───────┤       │       │
 │       │       │       │             │       │       │       │
 └───────┴───────┴───────┘      0      └───────┴───────┴───────┘

Example Code

C

#include  "dhcalls.h"

USHORT APIENTRY DevHelp_VMGlobalToProcess( ULONG Flags,
                                           LIN   LinearAddr,
                                           ULONG Length,
                                           PLIN  ProcessLinearAddr)