Bristol 621 - Page 27

Model 621 User’s Manual APPLICATION PROGRAMMING INTERFACE (API)
Bristol Instruments, Inc. 27
DECLSPEC int __cdecl CLCloseDevice(int DeviceHandle)
Function:
Closes the device using a USB Serial Port Interface. This command must be
called at the end of the program to properly release the port.
Parameters:
DeviceHandle: the device handle returned by the call to the
CLOpenUSBSerialDevice function.
Returns:
An integer error of –1 on failure, otherwise zero.
DECLSPEC int __cdecl CLSetMeasHBCallback(int DeviceHandle,
MEASHBCALLBACK ProcessMeasHBData)
Function:
Set a user defined callback function to receive measurement information from the
instrument when it is available.
Parameters:
DeviceHandle: a valid CLDevice handle.
ProcessMeasHBData: user supplied callback function.
Returns:
A valid CLDevice handle number, or –1 on failure.
DECLSPEC int __cdecl CLGet MeasurementData(int DevHandle,
tsMeasurementDataType*data)
Function:
Set a user defined callback function to receive measurement information from the
instrument when it is available.
Parameters:
DeviceHandle: a valid CLDevice handle.
Data: pointer to location to write data of type tsMeasurementDataType.
Returns:
–1 on failure.
DECLSPEC double __cdecl CLGetLambdaReading(int DevHandle);
Function:
Get the current wavelength reading.
Parameters:
DeviceHandle: a valid CLDevice handle.
Returns:
64 bit floating point wavelength reading in units of nanometers (nm).