#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的設備嘗試進行通訊,用于故障偵探及恢復嘗試.
	virtual BOOL  STDMETHODCALLTYPE TryConnect( char*  pDeviceName, int nUnitAddr, LPVOID lpDevAddr ) = 0;
	//將lpDbItem內的有關下位機的內容進行轉換并填充到lpVar中
	virtual WORD  STDMETHODCALLTYPE ConvertUserConfigToVar( LPVOID  lpDbItem, LPVOID lpVar ) = 0;
	//加載設備的特殊信息,板卡中使用較多
	virtual int   STDMETHODCALLTYPE LoadDeviceInfo( const char *sProducer, const char *sDeviceName, int nSubType ) = 0;
	
	//初始化通訊設備 如:(串口或板卡等)
	virtual BOOL  STDMETHODCALLTYPE OpenComDevice( int nDeviceType, LPVOID lpInitData ) = 0;
	//關閉該通訊設備
	virtual BOOL  STDMETHODCALLTYPE CloseComDevice() = 0;
	//初始化設備,設置該設備的初始化狀態,初始化信息從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;
	//根據協議處理包,若處理成功則返回真且將數據存入varList中,否則返回FALSE.
	virtual int   STDMETHODCALLTYPE ProcessPacket( LPVOID lpPacket ) = 0;
	//將字符串轉換為設備地址,若成功則返回TRUE,若地址字符串不合理則返回FALSE.
	virtual BOOL  STDMETHODCALLTYPE StrToDevAddr( const char * str, LPVOID lpDevAddr )=0;
	//返回最近一次的錯誤信息.
	virtual char * STDMETHODCALLTYPE GetLastError()=0;// int * errCode, char ** errStr );
};

#endif    //__PROTOCOLX_H__