Filter
Top Products
7 - 4
7.3 Internal Device Interface Function
7.3.1 GDev_OpenMapping (Opening and mapping the internal device shared memory)
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