National Instruments 320682C Musical Toy Instrument User Manual


 
RS-232 Library Chapter 5
LabWindows/CVI Standard Libraries 5-22 © National Instruments Corporation
GetRS232ErrorString
char *
message
=
GetRS232ErrorString
(int
errorNum
)
Purpose
Converts the error number returned by an RS-232 Library function into a meaningful error
message.
Parameters
Input
errorNum
integer Error Code returned by RS-232
function.
Return Value
message
string Explanation of error.
InstallComCallback
int
status
=
InstallComCallback
(int
COMPort
, int
eventMask
, int
notifyCount
,
int
eventCharacter
, ComCallbackPtr
callbackPtr
,
void *
callbackData
);
Note:
This function is available only in the Windows version of LabWindows/CVI
.
Purpose
This function allows you to install a callback function for a particular COM port. The callback
function is called whenever any of the events specified in the
eventMask
parameter occur on the
COM port and you allow the system to process events. The system can process events in the
following situations.
You have called RunUserInterface and none of your callback functions is currently
executing, or
You call GetUserEvent, or
You call ProcessSystemEvents
Only one callback function can apply for each COM port. Each call to this function for the same
COM port supersedes the previous call.
To disable callbacks for a board or device, pass 0 for the
eventMask
and/or
callbackFunction
parameters.