Справочник Пользователя для Mitsubishi Electronics SW2D5C-GTD2-E

7 - 4

7.3.1

GDev_OpenMapping (Opening and mapping the internal device shared 
memory)

The following shows details of the GDev_OpenMapping function.

(1) Function

Opens and maps the shared memory of the GOT internal device.

(2) Format

(a) For Visual C++

ulMapPointer = GDev_OpenMapping(*lphMapFile, sGotNo)

(b) For Visual Basic

ulMapPointer = GDev_OpenMapping(hMapFile, sGotNo)

(3) Explanation

The shared memory handle for the internal device of GT SoftGOT1000 that is specified by sGotNo 
is obtained, and map processing is performed with the handle.
The obtained shared memory handle is stored to lphMapFile or hMapFile, and the obtained shared 
memory address is stored to ulMapPointer.

(4) Return value

Normal termination: A number other than "0" (shared memory address) is returned.
Abnormal termination: "0" is returned.

(5) Precautions for using the GDev_OpenMapping function

After the GDev_OpenMapping function is called and required processings are performed, the 
GDev_CloseUnMapping function must always be called.
If it is not called, a memory leak may result and an error such as application error may occur.

Variable name

Variable type

Description

I/O

ulMapPointer

unsigned long

Return value (shared memory address)

Output

*lphMapFile

HANDLE

Shared memory handle

Output

sGotNo

short

Module No. of GT SoftGOT1000 (Fixed to 1)

Input

Variable name

Variable type

Description

I/O

ulMapPointer

unsigned long

Return value (shared memory address)

Output

hMapFile

HANDLE

Shared memory handle

Output

sGotNo

short

Module No. of GT SoftGOT1000 (Fixed to 1)

Input