Epson S1D13706 Technical Manual page 238

Page 78
DWORD seAllocMainWinSurface(DWORD Size)
DWORD seAllocSubWinSurface(DWORD Size)
Description:
Parameters:
Return Value:
int seFreeSurface(DWORD LinearAddress)
Description:
Parameters:
Return Value:
S1D13706
X31B-G-003-03
These functions allocate display buffer memory for a surface. If the surface previously had
memory allocated then that memory is first released. Newly allocated memory is not
cleared.
Call seAllocMainWinSurface() or seAllocSubWinSurface() to allocate the requested
amount of display memory for the indicated surface.
These functions allow an application to bypass the automatic surface allocation which
occurs when functions such as seInitReg() or seSetMode() are called.
Size The size in bytes of the requested memory block.
If the memory allocation succeeds then the return value is the linear address of the allo-
cated memory. If the allocation fails then the return value is 0. A linear address is a 32-bit
offset, in CPU address space.
This function can be called to free any previously allocated display buffer memory.
This function is intended to complement seAllocMainWinSurface() and seAllocSubWin-
Surface().
After calling one of these functions, the application must switch the active surface to one
which has memory allocated before calling any drawing functions.
LinearAddress A valid linear address. The linear address is a dword returned to the
application by any surface allocation call.
ERR_OK Function completed successfully.
ERR_FAILED Function failed.
Epson Research and Development
Vancouver Design Center
Programming Notes and Examples
Issue Date: 01/02/23