Epson S1D13706 - Page 237

Epson Research and Development
Page 77
Vancouver Design Center
Programming Notes and Examples S1D13706
Issue Date: 01/02/23 X31B-G-003-03
The functions in this section allow the application programmer a little greater control over
surfaces.
int seGetSurfaceDisplayMode(void)
Description:
This function determines the type of display associated with the current active surface.
Parameters:
None.
Return Value:
The return value indicates the active surface display type. Return values will be one of:
MAIN_WIN The main window is the active surface.
SUB_WIN The sub-window is the active surface.
DWORD seGetSurfaceSize(void)
Description:
This function returns the number of display memory bytes allocated to the current active
surface.
Parameters:
None.
Return Value:
The return value is the number of bytes allocated to the current active surface.
The return value will be 0 if this function is called before initializing the registers.
DWORD seGetSurfaceLinearAddress(void)
Description:
This function returns the linear address of the start of memory for the active surface.
Parameters:
None.
Return Value:
The return value is the linear address to the start of memory for the active surface. A linear
address is a 32-bit offset, in CPU address space.
The return value will be NULL if this function is called before a surface has been initial-
ized.
DWORD seGetSurfaceOffsetAddress(void)
Description:
This function returns the offset, from the first byte of display memory to the first byte of
memory associated with the active display surface.
Parameters:
None.
Return Value:
The return value is the offset, in bytes, from the start of display memory to the start of the
active surface. An address of 0 indicates the surface starts in the first byte of display buffer
memory.
Note
This function also returns 0 if there is no memory allocated to an active surface. You
must ensure that memory is allocated before calling seGetSurfaceOffsetAddress().