[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]

OpenScreenTagList() and its variants return a pointer to a Screen
structure on the successful creation of a new screen and NULL on failure.
With V36, the call now supports extended error codes on failure.  The
error returns provide information on the type of failure, giving the
application a greater chance of recovery.  To get the extended error code,
you need to use the SA_ErrorCode tag; the code itself will be placed into
the LONG pointed to by the TagItem.ti_Data field.  Here are the codes:

OSERR_NOMONITOR
    The monitor needed to display the requested mode is not available. An
    example of this error would be opening a Productivity mode screen on
    a system without a VGA or multisync monitor.

OSERR_NOCHIPS
    Newer custom chips are required for this screen mode.  For instance,
    the ECS Denise is required for the productivity modes.

OSERR_NOMEM
    Could not allocate enough memory.

OSERR_NOCHIPMEM
    Could not allocate enough Chip memory.

OSERR_PUBNOTUNIQUE
    Could not create public screen--name already used.  The system
    requires that public screen names be unique.

OSERR_UNKNOWNMODE
    Display mode requested was not recognized.  The system does not
    understand the value specified with the SA_DisplayID tag.