#ifndef  __ICOMPRO_H__
#define  __ICOMPRO_H__

//The interface ID for this special interface.
#define STR_IID_IPROTOCOL_IMP  0x2d921821, 0xd190, 0x11d1, { 0xbb, 0x16, 0x0, 0x40, 0x5, 0x62, 0x5a, 0xd7 }
static const IID IID_ProtocolImp = { STR_IID_IPROTOCOL_IMP };

//////////////////////////////////////////////////////////////////////////////
// CProtocolImp: Interface of Protocol.
class IProtocolImp : public IUnknown
{
public:	
	virtual HRESULT STDMETHODCALLTYPE QueryInterface(REFIID iid, void** ppvObj) = 0;
    virtual ULONG STDMETHODCALLTYPE AddRef() = 0;
    virtual ULONG STDMETHODCALLTYPE Release() = 0;

	//This Interface
	virtual BOOL  STDMETHODCALLTYPE GetRegisters( char *szDeviceName, LPVOID *ppReg, int *pRegNum ) = 0;
	//與地址為UnitAddr的設(shè)備嘗試進(jìn)行通訊,用于故障偵探及恢復(fù)嘗試.
	virtual BOOL  STDMETHODCALLTYPE TryConnect( char*  pDeviceName, int nUnitAddr, LPVOID lpDevAddr ) = 0;
	//將lpDbItem內(nèi)的有關(guān)下位機(jī)的內(nèi)容進(jìn)行轉(zhuǎn)換并填充到lpVar中
	virtual WORD  STDMETHODCALLTYPE ConvertUserConfigToVar( LPVOID  lpDbItem, LPVOID lpVar ) = 0;
	//加載設(shè)備的特殊信息,板卡中使用較多
	virtual int   STDMETHODCALLTYPE LoadDeviceInfo( const char *sProducer, const char *sDeviceName, int nSubType ) = 0;
	
	//初始化通訊設(shè)備 如:(串口或板卡等)
	virtual BOOL  STDMETHODCALLTYPE OpenComDevice( int nDeviceType, LPVOID lpInitData ) = 0;
	//關(guān)閉該通訊設(shè)備
	virtual BOOL  STDMETHODCALLTYPE CloseComDevice() = 0;
	//初始化設(shè)備,設(shè)置該設(shè)備的初始化狀態(tài),初始化信息從WIN.INI中得到
	virtual BOOL  STDMETHODCALLTYPE InitialDevice(char*  pDeviceName, int nUnitAddr, LPVOID lpDevAddr ) = 0;

	//判斷變量是否能夠加入到該包中一起采集:如果可以加入,返回TRUE并修改包的起止地址;否則返回FALSE.
	virtual BOOL  STDMETHODCALLTYPE AddVarToPacket( LPVOID lpVar, int nVarAccessType, LPVOID lpPacket) = 0;
	//根據(jù)協(xié)議處理包,若處理成功則返回真且將數(shù)據(jù)存入varList中,否則返回FALSE.
	virtual int   STDMETHODCALLTYPE ProcessPacket( LPVOID lpPacket ) = 0;
	//將字符串轉(zhuǎn)換為設(shè)備地址,若成功則返回TRUE,若地址字符串不合理則返回FALSE.
	virtual BOOL  STDMETHODCALLTYPE StrToDevAddr( const char * str, LPVOID lpDevAddr )=0;
	//返回最近一次的錯(cuò)誤信息.
	virtual char * STDMETHODCALLTYPE GetLastError()=0;// int * errCode, char ** errStr );
};

#endif    //__PROTOCOLX_H__