User manual

CPC_Handle
Syntax: #include cpc.h
struct CPC_MSG * CPC_Handle();
Description: CPC_Handle() checks for availability of a new
message from CPC-XTI. If a message is
available, all asynchronous handlers are
called in the sequence of their entry position
with the new message as parameter.
CPC_Handle() returns immediately,
independant of the availability of a message.
Return value: A pointer to a static memory area containing
the message is returned. This memory area
is overwritten during following calls to
CPC_Handle() and also on use of many of the
synchronous interface functions. If no
message is available, CPC_Handle() returns
NULL.
2.6 MS-Windows Driver Additional Information
Please notice: this subchapter refers to the
older version of the Windows Development
Kit. For information on the new version
please read the ‘CPC Series Development
Kit for MS Windows environment’ manual.
The software functionality and interface equals
the MS-DOS version. Differences exist in the
software setup and a few additional functions.
2.6.1 Installation
The installation is provided by the setup
program. Run SETUP.EXE from delivery disk.
User Manual CPC-XTI
EMS Dr. Thomas Wünsche 15
The installation program performs the
following actions:
•
copy the files
•
install entry for virtual device driver in
SYSTEM.INI (Windows9X)
2.6.2 Additional Functions
One additional function is necessary to
compensate the fact that the initialisation
structure is not directly accessible to the
application:
CPC_Get_Init_Params_Ptr
Syntax: #include “cpc.h”
structure CPC_INIT_PARAMS
CPC_Get_Init_Params_Ptr(void);
Description: This function provides access to the initializa-
tion structure, which is contained in the
Dynamic Link Library.
Return value: A pointer to the initialization structure in the
Dynamic Link Library.
CPC-XTI User Manual
16 EMS Dr. Thomas Wünsche