Iw51Datasink Methods - Wavecom W51PC User Manual

Iw51DataSink Methods

User Manual W51PC DCOM Interface V1.1
that the server will call into the client application using the Iw51DataSink
interface to send it the decoded data.
The types of data that can be returned are:
•
TEXT (Unicode characters for all text modes)
•
IMAGE (grayscale bitmap for fax modes)
•
SIGNAL (array of integers for signal analysis mode)
•
Parameters (e.g. baud rate)
•
FFT (array of integers for FFT mode)
•
New types possible in future...
This interface allows the server to communicate results to its clients.
interface IW51DataSink : IDispatch
{
HRESULT NewTextData([in] BSTR Data);
HRESULT NewRawData([in] long cMax,
[in, size_is(cMax)] BYTE *nData,
[in] long DataType);
HRESULT NewSystemStatus( [in] BOOL Idle,
[in] BOOL Traffic,
[in] BOOL Error,
[in] BOOL RQ,
[in] BOOL Auto,
[in] BOOL Sync,
[in] BOOL Phasing,
[in] long Level);
};
Three distinct types of data can be returned from the Server. These are
text data, raw data (for example fax, bitmap etc.) and system status re-
sults. The rate at which the server calls the client application is called the
update rate, and can be adjusted using the Iw51System interface's Se-
tUpdateRate function.
Description of methods in Iw51DataSink:
HRESULT NewTextData([in] BSTR Data);
This is the call-back function that will be called when new text data is
available. The text data is returned in a BSTR. This function can be
enabled or disabled using the EnableCallBackText function on the sys-
tem interface.
HRESULT NewRawData([in] long cMax, [in, size_is(cMax)] BYTE
*nData,[in] long DataType);
Called when new raw data as bit stream data becomes available. The
cMax parameter indicates the size of the data buffer, nData points to the
data and DataType indicates the type of data. This function can be
enabled or disabled using the EnableCallBackRaw function on the Sys-
tem interface.
Class W51Server • 9