關于主叫號碼的說明(WIN 95&NT 32位)


一、C語言函數調用：

1、BOOL WINAPI IsSupportCallerID(void);
    功能：  判斷該卡是否支持Caller-ID功能。
    參數：  無
    返回值：TRUE      支持
            FALSE       不支持
    例：

2、void WINAPI ResetCallerIDBuffer(WORD wChnlNo);
    功能：  初始化某路的Caller-ID緩沖區。
    參數：  ChannelNo    通道號
    返回值：無
    例：
	ResetCallerIDBuffer(ChannelNo);

3、WORD WINAPI GetCallerIDStr (WORD wChnlNo, LPSTR IDStr);
    功能：  獲得Caller-ID的內容。
    參數：  ChannelNo    通道號
    返回值： 接收的情況
		#DEFEIN	ID_STEP_NONE		0	//未收到任何信息
		#DEFEIN	ID_STEP_HEAD		1	//正在接收頭信息
		#DEFEIN	ID_STEP_ID		2	//正在接收ID號碼
		#DEFEIN	ID_STEP_OK		3	//接收完畢，正確	
		#DEFEIN	ID_STEP_FAIL		4	//接收完畢，較驗錯誤
	當返回值等于3或4時，CallerIdStr 中存有接收到的CallerID。
    例：
	char IDStr[MAX_CHANNEL_NO][MAX_CALLER_ID_NO];

	......
	r = GetCallerIDStr(ChannelNo,IDStr[ChannelNo]);
	if ( r == ID_STEP_OK ) {
		sprintf ( DispStr, "Channel = %d, Get Caller ID : [%s]\n", 
				ChannelNo, IDStr[ChannelNo] );
		break;
	}
	......

3、WORD WINAPI GetCallerIDRawStr (WORD wChnlNo, LPSTR IDRawStr);
    功能：  獲得C收到的Caller-ID的原始內容。
    參數：  ChannelNo    通道號
    返回值：目前已經收到的CallerID的個數。
        CallerISRawStr  字符串，存有接收到的CallerID原始信息串。
    說明：  在CallerIDRawStr中，存有已接收到 CallerID信息
    例：
	char IDStr[MAX_CHANNEL_NO][MAX_CALLER_ID_NO];

	......

	r = GetCallerIDRawStr (TestChnl,IDStr[TestChnl]);
	if ( r != 0) {
		sprintf ( DispStr, "Get Caller's ID (RAW): Total = %d, ", r );
		for ( i = 0; i < r; i ++ )
			sprintf ( DispStr, "%X ", IDStr[TestChnl][i] );
		count = r;
	}

說明：
    一般情況下，只需要配合使用以下的兩個函數即可：
2、void ResetCallerIDBuffer(int ChannelNo);
3、int GetCallerIDStr(int ChannelNo, char far *IDStr);

三、C示范程序ID.EXE：(用VC 2.0編寫)
    本程序用來演示有關收主叫號碼(Caller ID)的C語言函數，用戶可以參考來修改自己的程序。
    本程序也可以用來測試T5ID卡的硬件（收主叫部分）。
  1、文件組成：
		ID.MAK
		ID.C
		..\voc\HELLO.VOC
  2、插入外線模塊，接入電話線路，運行程序ID；當振鈴后，會將收到的主叫號碼顯示在屏幕上，然后放一句提示音，最后掛機。
  3、對于內線模塊，摘機后僅僅放一句提示音。
  4、注意ResetCallerIDBuffer( )函數的位置。有兩處，一處是在主循環之前；另一處是在一次流程完畢，進行掛機HangUp( )時調用。

四、自測程序IDCHK.EXE：(用VC 2.0編寫)
    當你的電話線路不傳送主叫號碼(Caller ID)時，可以用本程序來測試T5ID卡的硬件（收主叫部分）
  1、文件組成：
		IDCHK.MAK
		IDCHK.C
		..\voc\IDCHK.VOC
  2、插入內線模塊，接入內線電源，運行程序IDCHK；將對所有插內線模塊的通道進行測收到的號碼應該是1234567890。
  3、注意：
	確保內線模塊和內線電源能正常工作（可以用DEMO下的程序來試一下）。
    內線通道上不必接入電話機。