Wavecom W51PC, Руководство пользователя

Страница: 9 / 29

User Manual W51PC DCOM Interface V1.1 Class W51Server
•
5
coder mode, baud rate, frequency shift, etc. The client application can at
any time retrieve the state of the decoder card as it was set up using the
decoder user interface and the decoder user interface can retrieve the
state as it was set up using the client application. This is because the de-
coder user interface and the client application share the same
W51Server.
The list of parameters that make up the state of the decoder varies from
mode to mode and is also changed from time to time as new modes and
functionality are added to the decoder. To isolate the client application
from these changes, the state of the decoder is stored as a “blob” of data.
This is simply a variable length array of bytes. It is the responsibility of
the W51Server to create this blob when sending it to the client application
and to interpret the blob when it is received from the client application. All
that the client application has to do is to ensure that it sends the blob
back to the W51Server exactly the same way it was received. To allow
the client application to interpret the parameters that are inside the “blob”
a W51Param utility class is provided.
Iw51System Methods
Shown below is the IDL definition of the Iw51System interface. Each of
the functions (or methods) will be described.
interface IW51System : IDispatch
{
HRESULT Connect([in] BSTR CardName);
HRESULT ConnectByNumber([in] long lCardNumber);
HRESULT ActivateW51PC([in] BSTR ComputerName);
HRESULT SetParam([in] BSTR Blob);
HRESULT GetParam([out] BSTR* Blob);
HRESULT GetSystemStatus( [out] BOOL*Idle,
[out]BOOL*Traffic,
[out] BOOL*Error,
[out] BOOL*RQ,
[out] BOOL*Auto,
[out] BOOL*Sync,
[out] BOOL*Phasing)
[out] long*Level);
HRESULT SetUpdateRate([in] long lUpdateRate);
HRESULT GetTextData([out] BSTR *Data);
HRESULT GetRawData(
[in] long cMax,
[out] long*pcActual,
[out size_is(cMax),length_is(*pcActual)] BYTE Data);
HRESULT EnableCallBackText([in] BOOL Enable);
HRESULT EnableCallBackRaw([in] BOOL Enable);
HRESULT EnableCallBackStatus([in] BOOL Enable);
HRESULT GetCardStatus([out] long *Status);
HRESULT RawDataAsText([in] BOOL Enable);
HRESULT SystemIsReadyForParamChange([out] BOOL *IsReady);
HRESULT Reset();
HRESULT Resync();
};
Description of methods in Iw51System:
HRESULT Connect([in] BSTR CardName);
The card name is provided as a BSTR. These card names can be
changed using the Server Control application. This function initializes the
card by downloading code to the card. This function has to be called be-
fore the card can be used. Calling connect with another card name will
disconnect the current card and connect to the new card.
HRESULT ConnectByNumber([in] long lCardNumber);