开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > 通讯/手机编程 > TAPI编程 > 查看源码
TAPIEventProcess.cpp
资源名称：语音自动应答系统的实现.rar　[点击查看]
上传用户：fast168168
上传日期：2010-01-05
资源大小：337k
文件大小：35k
源码类别：

TAPI编程

开发平台：

Visual C++

TAPIEventProcess.cpp：源码内容
  2. #include "StdAfx.h"
  3. #include <tapi3.h>
  5. #include "tapieventprocess.h"
  8. const int Ver_Win2000 = 1;
  9. const int Ver_WinXP = 2;
  10. const int Timer_ID = 1;
  11. const int Max_Rec_Time = 60000;
  12. const DWORD ADDRESSLENGTH   = 128;
  16. ///////////////////////////////////////////////////////////////////
  17. // CallEventNotification::Event
  18. //
  19. // 1、这是ITCallEventNotification接口中的唯一的方法，当有事件被触发时，
  20. // TAPI 3.0 就会调用这个函数。
  21. // 2、这个函数里仅仅向用户界面线程（在本程序中可以理解为主对话框）发送一个消息，
  22. // 这样做的目的是在 TAPI 的 回调（callback）线程中包含尽量少的处理过程
  23. //
  24. ///////////////////////////////////////////////////////////////////
  26. HRESULT
  27. STDMETHODCALLTYPE
  28. CTAPIEventNotification::Event(
  29.                               TAPI_EVENT TapiEvent,
  30.                               IDispatch * pEvent
  31.                              )
  32. {
  33.     //
  34.     // 调用AddRef,计数器加1.
  35.     //
  36.     pEvent->AddRef();
  38.     //
  39.     // 向 UI 线程发送消息
  40.     //
  42.     PostMessage(
  43.                 m_hWnd,
  44.                 WM_PRIVATETAPIEVENT,
  45.                 (WPARAM) TapiEvent,
  46.                 (LPARAM) pEvent
  47.                );
  49.     return S_OK;
  50. }
  51. /*
  52. void CTAPIEventNotification::gg()
  53. {
  54.     PostMessage(
  55.                 m_hWnd,
  56.                 WM_PRIVATETAPIEVENT,
  57.                 0,
  58.                 0
  59.                );
  60. }
  61. */
  62. //////////////////////////////////////////////////////////////////////////////////////////////////////
  63. //
  64. // calss CTapi 实现代码
  65. //
  66. // 说明：
  67. // 1. 本类基于 TAPI3.1, 对 TAPI 的功能进行定制，满足特定需要
  68. // 功能：
  69. // 1. 对给定的电话号码呼叫
  70. // 2. 当有电话呼入时，给对方播放本地事先指定的声音文件
  71. // 3. 接受电话另一方的按键，分别对不同按键作出响应
  72. // 4. 具有来录音功能
  73. // 注意：
  74. // 1. 对 CTapi 类初始化时需要传入当前 UI（用户界面）的句柄，通过这个句柄向 UI 线程发送消息，在 UI
  75. //    线程中对 TAPI EVENT 进行响应。
  76. // 2. 需要 class CTAPIEventNotification 辅助，完成对事件的注册
  77. //////////////////////////////////////////////////////////////////////////////////////////////////////
  79. CTapi::CTapi()
  80. {
  81. m_pTapi = NULL;
  82. m_pAddress = NULL;
  83. m_pCall = NULL;
  84. m_AutoAnswer = false;
  85. m_pPlayFileTerm = NULL;
  86. m_pRecordFileTerm = NULL;
  87. m_Advise = 0;
  88. m_hWnd = 0;
  89. m_dwMessages = 0;
  90. m_Version = 0;
  92. m_WelcomeFileName = "Welcome.wav";
  93. m_RecFileName = "Message";
  94. m_RecFileExt = "avi";
  95. }
  97. CTapi::~CTapi()
  98. {
  100. }
  102. //////////////////////////////////////////////////////////////
  103. // InitializeTapi
  104. //
  105. // TAPI 初始化
  106. ///////////////////////////////////////////////////////////////
  107. HRESULT CTapi::InitializeTapi()
  108. {
  109.     HRESULT         hr;
  111.     //
  112.     // 初始化 TAPI object
  113.     //
  114.     hr = CoCreateInstance(
  115.                           CLSID_TAPI,
  116.                           NULL,
  117.                           CLSCTX_INPROC_SERVER,
  118.                           IID_ITTAPI,
  119.                           (LPVOID *)&m_pTapi
  120.                          );
  122.     if ( FAILED(hr) )
  123.     {
  124.         AfxMessageBox("初始化 TAPI 失败！");
  125.         return hr;
  126.     }
  128.     //
  129.     // 调用 initialize.  
  130. // 本函数必须在其它所有 TAPI 函数被调用之前调用
  131.     //
  132.     hr = m_pTapi->Initialize();
  134.     if ( FAILED(hr) )
  135.     {
  136.         AfxMessageBox("初始化 TAPI 失败！");
  138.         m_pTapi->Release();
  139.         m_pTapi = NULL;
  141.         return hr;
  142.     }
  144.     //
  145.     // 创建我们自己的事件处理实例并注册之，参见 CTAPIEventNodtification 的定义
  146.     //
  147.     CTAPIEventNotification *pTAPIEventNotification = new CTAPIEventNotification;
  149. //
  150. //将 CTapi中的窗口句柄传给 CTAPIEventNotification,由 CTAPIEventNotification 向UI进程发送消息
  151. //
  152. pTAPIEventNotification->m_hWnd = m_hWnd;
  154.     hr = RegisterTapiEventInterface(pTAPIEventNotification);
  156.     //
  157. // 这里已经不再需要 CALLBACK 对象，因为 TAPI 本身会在其内部创建并保留这个对象
  158.     //
  159.     pTAPIEventNotification->Release();
  161. OSVERSIONINFOEX osvi;
  162. BOOL bOsVersionInfoEx;
  164. //
  165. // 因为 TE_FILETERMINAL 只有在 Windows XP 下才支持，因此这里需要先判断操作系统的版本
  166. // 如果在 Windows XP 以下注册 TE_FILETERMINAL 消息时，这是 TAPI 将无法接受到任何消息！
  167. //
  168. // 获取操作系统版本，使用到结构体 OSVERSIONINFOEX 
  169. // 如果调用失败，再尝试用 OSVERSIONINFO 
  170. //
  172. ZeroMemory(&osvi, sizeof(OSVERSIONINFOEX));
  173. osvi.dwOSVersionInfoSize = sizeof(OSVERSIONINFOEX);
  175. if( !(bOsVersionInfoEx = GetVersionEx ((OSVERSIONINFO *) &osvi)) )
  176. {
  177. // 如果使用 OSVERSIONINFOEX 失败, 尝试 OSVERSIONINFO.
  179. osvi.dwOSVersionInfoSize = sizeof (OSVERSIONINFO);
  180. if (! GetVersionEx ( (OSVERSIONINFO *) &osvi) ) 
  181. return FALSE;
  182. }
  184. if(osvi.dwPlatformId == VER_PLATFORM_WIN32_NT)
  185. {
  186.       // 获得操作系统版本，Win2000以下忽略
  188.          if ( osvi.dwMajorVersion == 5 && osvi.dwMinorVersion == 0 )
  189.  {
  190.  // Windows 2000
  191.  m_Version = Ver_Win2000;
  192.  }
  194.          if ( osvi.dwMajorVersion == 5 && osvi.dwMinorVersion == 1 )
  195.  {
  196.  // Windows XP
  197.  m_Version = Ver_WinXP;
  198.  }
  199. }
  200. else
  201. {
  202. AfxMessageBox("您的操作系统版本太低，本系统至少要求在 Win2000 环境下");
  203. return E_FAIL;
  204. }
  205. //
  206. // 对我们所希望处理的事件设置事件进行事件过滤设置
  207. //
  208.     if(m_Version == Ver_Win2000)
  209. {
  210. hr = m_pTapi->put_EventFilter(TE_CALLNOTIFICATION | 
  211. TE_CALLSTATE  | 
  212. TE_CALLMEDIA  | 
  213. TE_DIGITEVENT );
  214. }
  215. else if(m_Version == Ver_WinXP)
  216. {
  217. hr = m_pTapi->put_EventFilter(TE_CALLNOTIFICATION | 
  218. TE_CALLSTATE  | 
  219. TE_CALLMEDIA  | 
  220. TE_DIGITEVENT |
  221. TE_FILETERMINAL); // TE_FILETERMINAL 只有在 WinXP 下才支持
  222. }
  224. if( FAILED(hr) )
  225. {
  226. AfxMessageBox("注册消息失败，系统无法接收到任何消息，但可以对其它号码呼叫");
  227. }
  229.     //
  230.     // 查找我们需的的 Address (本程序中为 Modem)并在其上开始侦听
  231.     //
  232.     hr = ListenOnAddresses();
  234.     if ( FAILED(hr) )
  235.     {
  236. //
  237. //如果失败，释放所之前所审请的资源
  238. //在 ListenOnAddresses 中已有错误信息输出，此处不需要再次输出 Errmsg
  239. //
  240.         m_pTapi->Release();
  241.         m_pTapi = NULL;
  243.         return hr;
  244.     }
  245.     return S_OK;
  246. }
  249. ///////////////////////////////////////////////////////////////
  250. // ShutdownTapi
  251. //
  252. // 功能：关闭 Tapi
  253. ///////////////////////////////////////////////////////////////
  254. void CTapi::ShutdownTapi()
  255. {
  256.     //
  257.     // 如果仍有一个 Call 存在的话，则挂断并释放之
  258.     //
  259.     DisconnectTheCall();
  261.     ReleaseTheCall();
  263.     //
  264. // 调用 Sleep 目的是为了留出一段时间让 TAPI 来挂断电话。
  265. // 因为对话框虽然会立即消失，但 TAPI 进程仍有可能未结束
  266. // 
  267.     Sleep(5000);
  269. //
  270.     // 释放主要的对象
  271.     //
  272.     if (NULL != m_pTapi)
  273.     {
  274.         m_pTapi->Shutdown();
  275.         m_pTapi->Release();
  276.     }
  277. }
  279. ///////////////////////////////////////////////////////////////////////////
  280. // RegisterTapiEventInterface
  281. //
  282. // 功能：注册 Tapi 事件接口
  283. ///////////////////////////////////////////////////////////////////////////
  284. HRESULT CTapi::RegisterTapiEventInterface(CTAPIEventNotification *pTAPIEventNotification)
  285. {
  286.     HRESULT                       hr = S_OK;
  287.     IConnectionPointContainer   * pCPC;
  288.     IConnectionPoint            * pCP;
  290.     //
  291. // 获得连接点容器
  292. //
  293.     hr = m_pTapi->QueryInterface(
  294.                                 IID_IConnectionPointContainer,
  295.                                 (void **)&pCPC
  296.                                );
  298.     if ( FAILED(hr) )
  299.     {
  300.         return hr;
  301.     }
  303.     //
  304. // 获得连接点
  305. //
  306. hr = pCPC->FindConnectionPoint(
  307.                                    IID_ITTAPIEventNotification,
  308.                                    &pCP
  309.                                   );
  311.     pCPC->Release();
  313.     if ( FAILED(hr) )
  314.     {
  315.         return hr;
  316.     }
  318. // m_Advise 用于取消注册之用
  319.     hr = pCP->Advise(
  320.                       pTAPIEventNotification,
  321.                       &m_Advise
  322.                      );
  324.     pCP->Release();
  326.     return hr;
  327. }
  330. //////////////////////////////////////////////////////////////
  331. // AddressSupportsMediaType
  332. //
  333. // 功能：验证给定的 Address 是否支持 给定的 MediaType
  334. // 返回：TRUE——支持；FALSE——不支持
  335. //////////////////////////////////////////////////////////////
  336. BOOL CTapi::AddressSupportsMediaType(
  337. ITAddress * pAddress,
  338. long        lMediaType
  339. )
  340. {
  341.     VARIANT_BOOL     bSupport = VARIANT_FALSE;
  342.     ITMediaSupport * pMediaSupport;
  343.   
  344.     if ( SUCCEEDED( pAddress->QueryInterface( IID_ITMediaSupport,
  345.                                               (void **)&pMediaSupport ) ) )
  346.     {
  347.         //
  348.         // 通过 pMediaSupport 验证 pAddress 是否支持 lMediaType
  349.         //
  350.         pMediaSupport->QueryMediaType(
  351.                                       lMediaType,
  352.                                       &bSupport
  353.                                      );
  355.         pMediaSupport->Release();
  356.     }
  358.     return (bSupport == VARIANT_TRUE);
  359. }
  363. ////////////////////////////////////////////////////////////////////////
  364. // ListenOnAddresses
  365. //
  366. // 功能：找到 Modem 所在的 Address，判断是否支持 AudioIn and AudioOut,
  367. // 如果都支持，则调用 ListenOnThisAddress 开始在此 Address 上侦听
  368. ////////////////////////////////////////////////////////////////////////
  369. HRESULT CTapi::ListenOnAddresses()
  370. {
  371.     HRESULT             hr = S_OK;
  372.     IEnumAddress *      pEnumAddress;
  373.     ITAddress *         pAddress;
  375.     //
  376.     // 列举所有的 Address
  377.     //
  378.     hr = m_pTapi->EnumerateAddresses( &pEnumAddress );
  380.     if ( FAILED(hr) )
  381.     {
  382.         return hr;
  383.     }
  385. BOOL bModem; //当前 Address 是否为 Modem 所有
  386. BOOL bState; //当前 Address 状态是否启用
  387. BOOL bListen; //当前 Address 上侦听是否成功
  389.     while ( TRUE )
  390.     {
  391.         //
  392.         // 获得下一个 Address
  393.         //
  394.         bModem = bState = bListen = FALSE;
  396. hr = pEnumAddress->Next( 1, &pAddress, NULL );
  398.         if (S_OK != hr)
  399.         {
  400.             break;
  401.         }
  403. BSTR bstrName; //当前 Address 名称
  404. ADDRESS_STATE state; //当前 Address 状态
  405. CString strName; //当前 Address 名称的 ASSIC 表示
  407. //
  408. // 获得当前 Address 名称，并判断是否为 Modem 所有，如果不是，结束本次循环，遍历一下 Address
  409. //
  410. pAddress->get_AddressName(&bstrName);
  411. strName = bstrName;
  412. SysFreeString(bstrName);
  413. strName.MakeLower();
  415. if( strName.Find("modem") == -1 )
  416. continue;
  417. //
  418. //找到了modem
  419. //
  420. bModem = TRUE;
  422. pAddress->get_State( &state);
  423. if( state != AS_INSERVICE)
  424. continue;
  425. //
  426. //上面找到的Modem目前处于启用状态
  427. //
  428. bState = TRUE;
  430.         //
  431. // 当前 Address 是否支持声音
  432. if ( AddressSupportsMediaType(pAddress, TAPIMEDIATYPE_AUDIO) )
  433.         {
  434.             //
  435.             // 如果支持声音，开始侦听
  436.             //
  437.             hr = ListenOnThisAddress( pAddress );
  439. if( SUCCEEDED(hr) )
  440. {
  441. //
  442. // 找到一个 Modem 设备,并且监听成功,退出函数
  443. // 检测当前 Address 能力，是否支持监视所有种类形式的按键
  444. //
  445.         ITAddressCapabilities *pAddressCaps = NULL;
  446.     long                    lType = 0;
  447. hr = pAddress->QueryInterface(IID_ITAddressCapabilities, (void**)&pAddressCaps);
  449. if ( SUCCEEDED(hr) )
  450. {
  452. hr = pAddressCaps->get_AddressCapability( AC_MONITORDIGITSUPPORT, &lType );
  453. if( SUCCEEDED(hr) )
  454. {
  455. if( !(lType & LINEDIGITMODE_DTMF) ) //LINEDIGITMODE_DTMFEND
  456. AfxMessageBox("您的 Modem 不支持音频拨号检测功能，无法获得音频拨号的电话机的按键");
  457. else if( !(lType & LINEDIGITMODE_PULSE) )
  458. AfxMessageBox("您的 Modem 不支持脉冲拨号检测功能，无法获得脉冲拨号的电话机的按键");
  459. }
  461. pAddressCaps->Release();
  463. m_pAddress = pAddress;
  464. pAddress->Release();
  465. pEnumAddress->Release();
  466. return S_OK;
  467. }
  468. }
  469.         }
  471.         pAddress->Release();
  472.     }
  474.     pEnumAddress->Release();
  476. //
  477. // 以下为对应的错误信息提示
  478. //
  479. if( !bModem )
  480. {
  481. AfxMessageBox("没有找到Modem,请检查您计算机那是否装有Modem");
  482. return E_FAIL;
  483. }
  484. if( !bState )
  485. {
  486. AfxMessageBox("系统监测到您机器内有Modem,但当前没又启用,请手工启用Modem之后在运行本程序");
  487. return E_FAIL;
  488. }
  489. if( !bListen )
  490. {
  491. AfxMessageBox("使用Modem监听失败,可能是您的 Modem 不支持语音，详情请于服务商联系");
  492. return E_FAIL;
  493. }
  494.     return S_OK;
  495. }
  497. ///////////////////////////////////////////////////////////////////
  498. // ListenOnThisAddress
  499. //
  500. // 功能：在调用这个函数之前，我们已经对所希望处理的事件进行了过滤设置，
  501. // 这里通过调用 RegisterCallNotifications 告诉 TAPI 我们将要在这个
  502. // Address 上触发那些已经设置的事件
  503. //
  504. ///////////////////////////////////////////////////////////////////
  505. HRESULT CTapi::ListenOnThisAddress(
  506. ITAddress * pAddress
  507. )
  508. {
  509.     long lMediaTypes = TAPIMEDIATYPE_AUDIO;
  511.     if ( AddressSupportsMediaType(pAddress, TAPIMEDIATYPE_VIDEO) )
  512.     {
  513.         lMediaTypes |= TAPIMEDIATYPE_VIDEO;
  514.     }
  516.     HRESULT  hr;
  517.     long     lRegister;
  519.     hr = m_pTapi->RegisterCallNotifications(
  520.                                            pAddress,
  521.                                            VARIANT_TRUE,
  522.                                            VARIANT_TRUE,
  523.                                            lMediaTypes,
  524.                                            0,
  525.                                            &lRegister
  526.                                           );
  528.     return hr;
  529. }
  532. /////////////////////////////////////////////////////////////////
  533. // MakeTheCall
  534. //
  535. // 功能：设置并呼叫号码
  536. /////////////////////////////////////////////////////////////////
  537. HRESULT
  538. CTapi::MakeTheCall(
  539.             IN DWORD dwAddressType,
  540.             IN PWCHAR szAddressToCall
  541.            )
  542. {
  543.     HRESULT                 hr = S_OK;
  544.     BSTR                    bstrAddressToCall;
  545. //
  546. // 检测当前地址是否有效
  547. //
  548. if( m_pAddress == NULL)
  549. return E_FAIL;
  551.     //
  552. // 这里我们只要求支持声音即可
  553. //
  554. long lMediaTypes = TAPIMEDIATYPE_AUDIO;
  555.     //
  556.     // 因为我们在对线路侦听时，已经确定 m_Address 至少支持声音，
  557. // 已经满足我们要求，不用另做检测
  558.     //
  560. //
  561.     // 建立呼叫
  562.     //
  563.     bstrAddressToCall = SysAllocString( szAddressToCall );
  565.     hr = m_pAddress->CreateCall( bstrAddressToCall,
  566.                                 dwAddressType,
  567.                                 lMediaTypes,
  568.                                 &m_pCall);
  570.     SysFreeString ( bstrAddressToCall );
  572.     if ( FAILED(hr) )
  573.     {
  574.         AfxMessageBox("建立呼叫失败！");
  576.         return hr;
  577.     }
  579.     //
  580.     // 为当前呼叫选择终端
  581.     //
  582.     hr = SelectTerminalsOnCall(m_pAddress, m_pCall );
  584. //
  585. // 正式发出呼叫
  586. //
  587.     hr = m_pCall->Connect( VARIANT_TRUE );
  589.     if ( FAILED(hr) )
  590.     {
  591.         m_pCall->Release();
  592.         m_pCall = NULL;
  594.         AfxMessageBox("无法连接！");
  596.         return hr;
  597.     }
  598.     return S_OK;
  599. }
  601. /////////////////////////////////////////////////////////
  602. // GetTerminal
  603. //
  604. // 为输入 stream 创建默认的 terminal,并通过 ppTerminal 返回
  605. //
  606. /////////////////////////////////////////////////////////
  607. HRESULT CTapi::GetTerminal(
  608.             ITAddress   * pAddress,
  609.             ITStream    * pStream,
  610.             ITTerminal ** ppTerminal
  611.            )
  612. {
  613.     //
  614.     // 确定当前传入 stream 的 media type 和 direction
  615.     //
  617.     HRESULT            hr;
  618.     long               lMediaType;
  619.     TERMINAL_DIRECTION dir;
  621.     hr = pStream->get_MediaType( &lMediaType );
  622.     if ( FAILED(hr) ) return hr;
  624.     hr = pStream->get_Direction( &dir );
  625.     if ( FAILED(hr) ) return hr;
  627.     //
  628. // 这里我们人处理 Audio 流，对于 Video 流，我们不令做处理
  629.     // 因此只调用 GetDefaultStaticTerminal.
  630. // 首先，获得 ITTerminalSupport 接口 
  631.     //
  633.     ITTerminalSupport * pTerminalSupport;
  635.     hr = pAddress->QueryInterface( IID_ITTerminalSupport,
  636.                                    (void **)&pTerminalSupport);
  638.     if ( SUCCEEDED(hr) )
  639.     {
  640.         //
  641. // 为这种 MediaType 和 Direction 获得默认的 Terminal
  642.         //
  644.         hr = pTerminalSupport->GetDefaultStaticTerminal(lMediaType,
  645.                                                         dir,
  646.                                                         ppTerminal);
  648.         pTerminalSupport->Release();
  649.     }
  651.     return hr;
  652. }
  654. /////////////////////////////////////////////////////////////////
  655. // SelectTerminalOnCall
  656. //
  657. // 在给定的 call 上中的 stream 中选择一个适当的 terminal
  658. /////////////////////////////////////////////////////////////////
  660. HRESULT CTapi::SelectTerminalsOnCall(
  661.                      ITAddress * pAddress,
  662.                      ITBasicCallControl * pCall
  663.                      )
  664. {
  665.     HRESULT hr;
  667.     //
  668.     // 为当前 call 获得 ITStreamControl 接口
  669.     //
  671.     ITStreamControl * pStreamControl;
  673.     hr = pCall->QueryInterface(IID_ITStreamControl,
  674.                                (void **) &pStreamControl);
  676.     if ( SUCCEEDED(hr) )
  677.     {
  678.         //
  679.         // 列举所有的 stream
  680.         //
  682.         IEnumStream * pEnumStreams;
  684.         hr = pStreamControl->EnumerateStreams(&pEnumStreams);
  686.         pStreamControl->Release();
  688.         if ( SUCCEEDED(hr) )
  689.         {
  690.             //
  691.             // 遍历所有的 stream
  692.             //
  694.             ITStream * pStream;
  696.             while ( S_OK == pEnumStreams->Next(1, &pStream, NULL) )
  697.             {
  698.                 ITTerminal * pTerminal;
  700.                 //
  701. // 找出当前 stream 的 media type 和 direction,
  702. // 并且为这种 media type 和 direction 创建默认的 terminal 
  703.                 //
  705.                 hr = GetTerminal(pAddress,
  706.                                  pStream,
  707.                                  &pTerminal);
  709.                 if ( SUCCEEDED(hr) )
  710.                 {
  711.                     //
  712. // 对当前的 Stream 选择上面获得的 Terminal
  713.                     //
  715.                     hr = pStream->SelectTerminal(pTerminal);
  717.                     pTerminal->Release();
  718.                 }
  720.                 pStream->Release();
  721.             }
  723.             pEnumStreams->Release();
  724.         }
  725.     }
  726.     return hr;
  727. }
  729. /////////////////////////////////////////////////////////////////
  730. // PreparePlay
  731. //
  732. // 功能：播放给定的声音文件
  733. /////////////////////////////////////////////////////////////////
  734. HRESULT 
  735. CTapi::PreparePlay(CString strFileName)
  736. {
  737. //
  738. // 检测当前的 call object 是否有效
  739. //
  740.     if (NULL == m_pCall)
  741.     {
  742.         AfxMessageBox("AnswerTheCall: Call object 无效");
  743.         return E_UNEXPECTED;
  744.     }
  746. //
  747. // 如果 m_pPlayFileTerm 不是NULL,先释放之
  748. //
  749.     if(NULL != m_pPlayFileTerm)
  750. {
  751. m_pPlayFileTerm->Release();
  752. m_pPlayFileTerm = NULL;
  753. }
  755.     //
  756. // 为请求终端作准备 - 需要 ITBasicCallControl2 接口，只有在 TAPI3.1 中才支持
  757. //
  758.     ITBasicCallControl2*    pITBCC2 = NULL;
  759.     HRESULT hr = m_pCall->QueryInterface( IID_ITBasicCallControl2, (void**)&pITBCC2 );
  760. if(FAILED(hr))
  761. {
  762.         AfxMessageBox("AnswerTheCall: QI ITBasicCallControl2 failed");
  763.         m_pCall->Disconnect(DC_NORMAL);
  764. return hr;
  765. }
  767.     //
  768. // 为请求终端作准备 - need CLSID BSTR 
  769. //
  770. BSTR bstrCLSID = NULL;
  771. hr = StringFromCLSID(CLSID_FilePlaybackTerminal, &bstrCLSID);
  772. if(FAILED(hr))
  773. {
  774. pITBCC2->Release();
  775.         AfxMessageBox("AnswerTheCall: StringFromCLSID failed");
  776.         m_pCall->Disconnect(DC_NORMAL);
  777. return hr;
  778. }
  780. //
  781. //正式请求终端，需要媒体流类型和媒体流方向
  782. //
  783. hr = pITBCC2->RequestTerminal(bstrCLSID, 
  784. TAPIMEDIATYPE_AUDIO, 
  785. TD_CAPTURE, 
  786. &m_pPlayFileTerm);
  787. //
  788. //释放内存
  789. //
  790. ::CoTaskMemFree(bstrCLSID);
  792. if(FAILED(hr))
  793. {
  794. pITBCC2->Release();
  795.         AfxMessageBox("AnswerTheCall: RequestTerminal failed");
  796.         m_pCall->Disconnect(DC_NORMAL);
  797. return hr;
  798. }
  800. //
  801. // 为设置文件名作准备
  802. //
  803. BSTR bstrFileName = strFileName.AllocSysString();
  805. if(NULL == bstrFileName)
  806. {
  807. m_pPlayFileTerm->Release();
  808. m_pPlayFileTerm = NULL;
  809. pITBCC2->Release();
  810.         AfxMessageBox("AnswerTheCall: SysAllocString for play list failed");
  811.         m_pCall->Disconnect(DC_NORMAL);
  812. return E_OUTOFMEMORY;
  813. }
  815. //
  816. // 为 m_pPlayFileTerm 设置文件名
  817. //
  818. hr = PutPlayList(m_pPlayFileTerm, bstrFileName);
  820. //
  821. // 释放内存
  822. //
  823. ::SysFreeString(bstrFileName);
  825. if(FAILED(hr))
  826. {
  827. m_pPlayFileTerm->Release();
  828. m_pPlayFileTerm = NULL;
  829. pITBCC2->Release();
  830. AfxMessageBox("AnswerTheCall: PutPlayList failed");
  831. m_pCall->Disconnect(DC_NORMAL);
  832. return hr;
  833. }
  835. //
  836. // 用 ITBasicCallControl2 选择终端
  837. //
  838. hr = pITBCC2->SelectTerminalOnCall(m_pPlayFileTerm);
  839. if(FAILED(hr))
  840. {
  841. m_pPlayFileTerm->Release();
  842. m_pPlayFileTerm = NULL;
  843. pITBCC2->Release();
  844.         AfxMessageBox("AnswerTheCall: SelectTerminalOnCall failed");
  845.         m_pCall->Disconnect(DC_NORMAL);
  846. return hr;
  847. }
  849. pITBCC2->Release();
  850. return S_OK;
  851. }
  854. /////////////////////////////////////////////////////////////////////
  855. // Answers the call
  856. //
  857. // 功能：应答电话，创建并选择播放的终端
  858. /////////////////////////////////////////////////////////////////////
  859. HRESULT
  860. CTapi::AnswerTheCall()
  861. {
  863. HRESULT hr;
  864. hr = PreparePlay(m_WelcomeFileName);
  866. if( FAILED(hr) )
  867. {
  868. AfxMessageBox("无法找到" + m_WelcomeFileName + "文件或该文件不是合法的语音文件！");
  869. return E_FAIL;
  870. }
  871. //
  872. // 现在可以正式应答电话了
  873. //
  874.     hr = m_pCall->Answer();
  875. if(FAILED(hr))
  876. {
  877. m_pPlayFileTerm->Release();
  878. m_pPlayFileTerm = NULL;
  879.         AfxMessageBox("AnswerTheCall: Answer failed");
  880.         m_pCall->Disconnect(DC_NORMAL);
  881. return hr;
  882. }
  884. //
  885. // 到此正常结束
  886. //
  887. // pITBCC2->Release();
  888.     return S_OK;
  889. }
  892. //////////////////////////////////////////////////////////////////////
  893. // DisconnectTheCall
  894. //
  895. // 功能：挂断电话
  896. //////////////////////////////////////////////////////////////////////
  897. HRESULT CTapi::DisconnectTheCall()
  898. {
  899.     HRESULT         hr = S_OK;
  901.     if (NULL != m_pCall)
  902.     {
  903.         hr = m_pCall->Disconnect( DC_NORMAL );
  905. //
  906.         // 暂时不要释放 m_pCall，因为这样做的话我们无法得到 Disconnected 消息
  907. //
  909. return hr;
  910.     }
  912.     return S_FALSE;
  913. }
  916. //////////////////////////////////////////////////////////////////////
  917. // ReleaseTheCall
  918. //
  919. // 释放通话过程中所用到的 object
  920. //
  921. //////////////////////////////////////////////////////////////////////
  923. void
  924. CTapi::ReleaseTheCall()
  925. {
  927. // KillTimer(m_hWnd, TIMER_ID);
  929. //
  930. // 释放终端
  931. //
  932. if(NULL != m_pPlayFileTerm)
  933. {
  934. m_pPlayFileTerm->Release();
  935. m_pPlayFileTerm = NULL;
  936. }
  937. if(NULL != m_pRecordFileTerm)
  938. {
  939. m_pRecordFileTerm->Release();
  940. m_pRecordFileTerm = NULL;
  941. }
  942. //
  943. // 释放 call object - 这样会同时释放所有的被选择过得终端
  944. //
  945.     if (NULL != m_pCall)
  946.     {
  947.         m_pCall->Release();
  948.         m_pCall = NULL;
  949.     }
  950. }
  952. //////////////////////////////////////////////////////////////////
  953. // PutPlayList 
  954. //
  955. // 功能：将要播放的声音文件放入播放列表。调用了 put_PlayList 
  956. //////////////////////////////////////////////////////////////////
  957. HRESULT CTapi::PutPlayList(
  958. IN ITTerminal *pITTerminal, 
  959. IN BSTR bstrFileName)
  960. {
  961. //
  962. // 检测输入的终端是否有效
  963. //
  964. if(NULL == pITTerminal)
  965. {
  966.         AfxMessageBox("PutPlayList: playback terminal NULL");
  967. return E_UNEXPECTED;
  968. }
  970. //
  971.     // 获得 ITMediaPlayback 接口 
  972. //
  973.     ITMediaPlayback*    pMediaPlayback = NULL;
  975.     HRESULT hr = pITTerminal->QueryInterface(
  976. IID_ITMediaPlayback,
  977. (void**)&pMediaPlayback);
  979. if(FAILED(hr))
  980. {
  981.         AfxMessageBox("PutPlayList: QI ITMediaPlayback failed");
  982. return hr;
  983. }
  985. //
  986. // put_PlayList 函数需要用到的 VARIANT 变量
  987. //
  988. VARIANT varPlaylist;
  989. VariantInit(&varPlaylist);
  991. //
  992. // 设置 SAFEARRAYBOUND 
  993. //
  994.     SAFEARRAYBOUND DimensionBounds;
  995.     DimensionBounds.lLbound = 1;
  997. //
  998. // 设置 playlist 中的文件数
  999. //
  1000.     DimensionBounds.cElements = 1;
  1002.     //
  1003. // 把文件名置于 playlist 中的 index = 1处
  1004. //
  1005.     long lArrayPos = 1;
  1007. //
  1008. // 用于存放文件名 - 用于把文件名加入到 SafeArray
  1009. //
  1010.     VARIANT* pvarArrayEntry = new VARIANT;
  1011.     if( pvarArrayEntry == NULL)
  1012.     {
  1013.         AfxMessageBox("PutPlayList: new VARIANT failed");
  1014.         return E_OUTOFMEMORY;
  1015.     }
  1016. VariantInit(pvarArrayEntry);
  1018.     //
  1019. // 创建 SAFEARRAY
  1020. //
  1021.     SAFEARRAY *pPlayListArray = NULL;
  1022.     pPlayListArray = SafeArrayCreate( VT_VARIANT, 1, &DimensionBounds);
  1023.     if( pPlayListArray == NULL)
  1024.     {
  1025.         AfxMessageBox("PutPlayList: SafeArrayCreate failed");
  1026. delete pvarArrayEntry;
  1027.         return E_OUTOFMEMORY;
  1028.     }
  1030. //
  1031. // 正式把存储在 pvarArrayEntry 中的文件名加入到 SafeArray 中
  1032. // 当我们需要加入多个元素到 SafeArray 中时，只需让 lArrayPos 加 1 即可
  1033. //
  1034.     pvarArrayEntry->vt = VT_BSTR;
  1035.     pvarArrayEntry->bstrVal = ::SysAllocString(bstrFileName);
  1036.     SafeArrayPutElement( pPlayListArray, &lArrayPos, pvarArrayEntry);
  1037. VariantClear(pvarArrayEntry);
  1039. //
  1040. // 准备varPlaylist, 为调用 put_PlayList 作准备
  1041. //
  1042.     V_VT(&varPlaylist) = VT_ARRAY | VT_VARIANT;
  1043.     V_ARRAY(&varPlaylist) = pPlayListArray;
  1045. //
  1046. // 最后，现在可以调用 put_PlayList 把 varPlaylist 放入到播放列表里了
  1047. //
  1048.     hr = pMediaPlayback->put_PlayList(varPlaylist);
  1049.     if(FAILED(hr))
  1050.     {
  1051.         AfxMessageBox("PutPlayList: put_PlayList failed");
  1052. delete pvarArrayEntry;
  1053.         return E_OUTOFMEMORY;
  1054.     }
  1056. //
  1057. //释放内存
  1058. //
  1059. delete pvarArrayEntry;
  1060.     pMediaPlayback->Release();
  1061. VariantClear(&varPlaylist);
  1063.     return hr;
  1064. }
  1066. ///////////////////////////////////////////////////////////////////
  1067. // StartRecord
  1068. //
  1069. //
  1070. // 功能：录音
  1071. // 说明：只有 WinXP 下才支持
  1072. ///////////////////////////////////////////////////////////////////
  1073. HRESULT CTapi::StartRecord()
  1074. {
  1075. HRESULT hr;
  1076. hr = CreateAndSelectFileRecordTerminal();
  1077. if(FAILED(hr))
  1078. {
  1079. //
  1080. // 致命错误 - 无法继续下去 - 切断此次通话
  1081. //
  1082. m_pCall->Disconnect(DC_NORMAL);
  1083. AfxMessageBox("CreateAndSelectFileRecordTerminal failed");
  1084. return hr;
  1085. }
  1087. //
  1088. // 获得 ITMediaControl 接口 - we need to call Start
  1089. //
  1090. ITMediaControl* pITMC = NULL;
  1091. hr = m_pRecordFileTerm->QueryInterface(IID_ITMediaControl, (void**)&pITMC);
  1092. if(FAILED(hr))
  1093. {
  1094. //
  1095. // 致命错误 - 无法继续下去 - 切断此次通话
  1096. //
  1097.     AfxMessageBox("ITFileTerminalEvent, but failed to QI ITMediaControl");
  1098. m_pCall->Disconnect(DC_NORMAL);
  1099. return hr;
  1100. }
  1102. hr = pITMC->Start();
  1103. pITMC->Release();
  1104. if(FAILED(hr))
  1105. {
  1106. //
  1107. // 致命错误 - 无法继续下去 - 切断此次通话
  1108. //
  1109.     AfxMessageBox("ITFileTerminalEvent, but ITMediaControl::Start");
  1110. m_pCall->Disconnect(DC_NORMAL);
  1111. return hr;
  1112. }
  1115. //
  1116. // 录音一分钟后自动停止
  1117. //
  1118. SetTimer(m_hWnd,Timer_ID, Max_Rec_Time, NULL);
  1119. m_dwMessages++;
  1120. KillTimer(m_hWnd,Timer_ID); 
  1121. return S_OK;
  1122. }
  1125. ///////////////////////////////////////////////////////////////////
  1126. // CheckStreamMT
  1127. //
  1128. // 检测输入的 pITStream 是否支持给定的媒体类型
  1129. //
  1130. ///////////////////////////////////////////////////////////////////
  1131. HRESULT CTapi::CheckStreamMT(
  1132. IN ITStream* pITStream,
  1133. IN long mt)
  1134. {
  1135. long mtStream = TAPIMEDIATYPE_AUDIO;
  1136. HRESULT hr = E_FAIL;
  1137. if(FAILED(hr=pITStream->get_MediaType(&mtStream)))
  1138. {
  1139. return hr;
  1140. }
  1141. if(!(mt&mtStream))
  1142. {
  1143. return S_FALSE;
  1144. }
  1145. else
  1146. {
  1147. return S_OK;
  1148. }
  1149. }
  1151. ///////////////////////////////////////////////////////////////////
  1152. // CheckStreamDir
  1153. //
  1154. // 检测输入的 pITStream 是否有给定的媒体流方向
  1155. //
  1156. ///////////////////////////////////////////////////////////////////
  1157. HRESULT CTapi::CheckStreamDir(
  1158. IN ITStream* pITStream,
  1159. IN TERMINAL_DIRECTION td)
  1160. {
  1161. TERMINAL_DIRECTION tdStream = TD_CAPTURE ;
  1162. HRESULT hr =E_FAIL;
  1163. if(FAILED(hr=pITStream->get_Direction(&tdStream)))
  1164. {
  1165. return hr;
  1166. }
  1167. if(td!=tdStream)
  1168. {
  1169. return S_FALSE;
  1170. }
  1171. else
  1172. {
  1173. return S_OK;
  1174. }
  1175. }
  1178. ///////////////////////////////////////////////////////////////////
  1179. // CreateAndSelectFileRecordTerminal
  1180. //
  1181. // 功能：
  1182. // 1. 创建录音文件终端，
  1183. // 2. 并对其指定录音文件名， 
  1184. // 3. 对当前输入媒体流选择音轨终端
  1185. ///////////////////////////////////////////////////////////////////
  1186. HRESULT CTapi::CreateAndSelectFileRecordTerminal()
  1187. {
  1189. //
  1190.     // 检测当前 m_pCall 是否有效
  1191.     //
  1192.     if (NULL == m_pCall) 
  1193.     {
  1194.         AfxMessageBox("CreateAndSelectFileRecordTerminal: m_pCall 无效，可能当前没有通话");
  1195.         return E_UNEXPECTED;
  1196.     }
  1198.     //
  1199.     // 获得 ITStreamControl 接口
  1200.     //
  1201. ITStreamControl* pStreamControl = NULL;
  1202.     HRESULT hr = m_pCall->QueryInterface( IID_ITStreamControl, (void**)&pStreamControl );
  1203.     if (FAILED(hr))
  1204.     {
  1205.         AfxMessageBox("CreateAndSelectFileRecordTerminal: QI for ITStreamControl failed");
  1206.         return E_FAIL;
  1207.     }
  1209. //
  1210. // 确保录音终端在这之前已经释放
  1211. //
  1212. if(NULL != m_pRecordFileTerm)
  1213. {
  1214. m_pRecordFileTerm->Release();
  1215. m_pRecordFileTerm = NULL;
  1216. }
  1218.     //
  1219. // QI for ITBasicCallControl2 - 准备请求终端
  1220. //
  1221. ITBasicCallControl2* pITBCC2 = NULL;
  1222.     hr = m_pCall->QueryInterface( IID_ITBasicCallControl2, (void**)&pITBCC2 );
  1223. if(FAILED(hr))
  1224. {
  1225. pStreamControl->Release();
  1226. AfxMessageBox("CreateAndSelectFileRecordTerminal: QI for ITBasicCallControl2 failed");
  1227. return hr;
  1228. }
  1230. //
  1231. // 为 ReqestTerminal 获得 CLSID
  1232. //
  1233. BSTR bstrCLSID = NULL;
  1234. hr = StringFromCLSID(CLSID_FileRecordingTerminal, &bstrCLSID);
  1235. if(FAILED(hr))
  1236. {
  1237. pITBCC2->Release();
  1238. pStreamControl->Release();
  1239. AfxMessageBox("CreateAndSelectFileRecordTerminal: StringFromCLSID failed");
  1240. return hr;
  1241. }
  1242. //
  1243. // 请求录音终端，需要输入 媒体类型 和 媒体流方向
  1244. //
  1245. hr = pITBCC2->RequestTerminal(bstrCLSID, 
  1246. TAPIMEDIATYPE_AUDIO, 
  1247. TD_RENDER, 
  1248. &m_pRecordFileTerm);
  1249. //
  1250. // 释放内存
  1251. //
  1252. ::CoTaskMemFree(bstrCLSID);
  1253. pITBCC2->Release();
  1254. if(FAILED(hr))
  1255. {
  1256. pStreamControl->Release();
  1257. AfxMessageBox("CreateAndSelectFileRecordTerminal: RequestTerminal failed");
  1258. return hr;
  1259. }
  1261.     //
  1262. // 获得 ITMediaRecord 接口，然后可以调用 put_FileName 来指定要录音的文件名
  1263.     //
  1264. ITMediaRecord* pITMediaRec = NULL;
  1265.     hr = m_pRecordFileTerm->QueryInterface( IID_ITMediaRecord, (void**)&pITMediaRec );
  1266. if(FAILED(hr))
  1267. {
  1268. pStreamControl->Release();
  1269. AfxMessageBox("CreateAndSelectFileRecordTerminal: QI ITMediaRecord failed");
  1270. return hr;
  1271. }
  1273. //
  1274. // 为受到的每一个消息建立不同的文件，一文件名后面的数字来区分
  1275. //
  1276. CString RecFileName;
  1277. CString tmp;
  1278. tmp.Format("%d.", m_dwMessages);
  1279. RecFileName = m_RecFileName + tmp + m_RecFileExt;
  1280. BSTR bstrFileName = RecFileName.AllocSysString();
  1282. if(NULL == bstrFileName)
  1283. {
  1284. pStreamControl->Release();
  1285. AfxMessageBox("CreateAndSelectFileRecordTerminal: SysAllocString failed");
  1286. return E_OUTOFMEMORY;
  1287. }
  1289. //
  1290. // 设置文件名
  1291. //
  1292. hr = pITMediaRec->put_FileName(bstrFileName);
  1294. //
  1295. // 释放内存
  1296. //
  1297. ::SysFreeString(bstrFileName);
  1298. pITMediaRec->Release();
  1300. if(FAILED(hr))
  1301. {
  1302. pStreamControl->Release();
  1303. AfxMessageBox("CreateAndSelectFileRecordTerminal: put_FileName failed");
  1304. return hr;
  1305. }
  1307.     //
  1308.     // 获得 ITMultiTrackTerminal 接口
  1309.     //
  1310. ITMultiTrackTerminal* pMTRecTerminal = NULL;
  1311.     hr = m_pRecordFileTerm->QueryInterface( IID_ITMultiTrackTerminal, (void**)&pMTRecTerminal );
  1312. if(FAILED(hr))
  1313. {
  1314. pStreamControl->Release();
  1315. AfxMessageBox("CreateAndSelectFileRecordTerminal: QI IID_ITMultiTrackTerminal failed");
  1316. return hr;
  1317. }
  1319.     //
  1320.     // 列举所有的媒体流
  1321.     //
  1322.     IEnumStream* pEnumStreams = NULL;
  1323.     hr = pStreamControl->EnumerateStreams(&pEnumStreams);
  1324.     pStreamControl->Release();
  1326.     if (FAILED(hr))
  1327.     {
  1328. pMTRecTerminal->Release();
  1329. AfxMessageBox("CreateAndSelectFileRecordTerminal: EnumerateStreams failed");
  1330. return hr;
  1331.     }
  1333. //
  1334. // 只处理音频媒体类型
  1335. //
  1336. long lMediaTypes = TAPIMEDIATYPE_AUDIO;
  1338.     //
  1339.     // 遍历媒体流，创建我们需要的
  1340.     //
  1341. ITStream* pStream = NULL;
  1342.     while (S_OK == pEnumStreams->Next(1, &pStream, NULL))
  1343.     {
  1344.         
  1345.         if ( (S_OK==CheckStreamMT(pStream,lMediaTypes))
  1346. && (S_OK==CheckStreamDir(pStream,TD_RENDER))) 
  1347.         {
  1348.             //
  1349. // 我们已经有了录音文件终端，下面要创建音轨终端
  1350.             //
  1351.             ITTerminal* pRecordingTrack = NULL;
  1353. //
  1354. // 检测媒体类型
  1355. //
  1356. long lStreamMediaType=0;
  1357. hr = pStream->get_MediaType(&lStreamMediaType);
  1358.             if (FAILED(hr))
  1359.             {
  1360. pStream->Release();
  1361. pStream=NULL;
  1362.                 continue;
  1364.             }
  1366. //
  1367. // 创建音轨终端
  1368. //
  1369.             hr = pMTRecTerminal->CreateTrackTerminal(lStreamMediaType, TD_RENDER, &pRecordingTrack);
  1370. if (FAILED(hr))
  1371.             {
  1372. pStream->Release();
  1373. pStream=NULL;
  1374.                 break;
  1375.             }
  1377.             //
  1378. // 让当前媒体流选择音轨终端
  1379. //
  1380. hr = pStream->SelectTerminal(pRecordingTrack);
  1382. //
  1383. // 释放内存
  1384. //
  1385. pStream->Release();
  1386. pStream=NULL;
  1387.             pRecordingTrack->Release();
  1388. pRecordingTrack=NULL;
  1390.             if (FAILED(hr))
  1391.             {
  1392.                 break;
  1393.             }
  1395. lMediaTypes^=lStreamMediaType;
  1397. if(lMediaTypes==0)
  1398. {
  1399.             // 
  1400. // 我们已经为所有媒体类型选择了终端，任务完成！
  1401. //
  1402. break;
  1403. }
  1406.         } 
  1407. //
  1408. // 释放内存
  1409. //
  1410. if(pStream!=NULL)
  1411. {
  1412. pStream->Release();
  1413. pStream = NULL;
  1414. }
  1416.     } // while (enumerating streams on the call)
  1419. //
  1420. //释放内存
  1421. //
  1422.     pMTRecTerminal->Release();
  1423. pEnumStreams->Release();
  1424.     
  1425. //
  1426. // 检测我们是否已经为所有媒体选择了终端
  1427. //
  1428.     if (lMediaTypes==0)
  1429.     {
  1430.         return S_OK;
  1431.     }
  1432.     else
  1433.     {
  1434. AfxMessageBox("CreateAndSelectFileRecordTerminal: no streams available");
  1435.         return E_FAIL;
  1436.     }
  1437. }
  1440. ///////////////////////////////////////////////////////////////////
  1441. // SameCall
  1442. //
  1443. // 检测是否与 m_pCall 是同一个
  1444. //
  1445. ///////////////////////////////////////////////////////////////////
  1446. bool CTapi::SameCall(ITCallStateEvent* pCallStateEvent)
  1447. {
  1448. if(NULL == pCallStateEvent)
  1449. {
  1450. return false;
  1451. }
  1453. //
  1454. // 获得 Call object
  1455. //
  1456. ITCallInfo* pCallInfo = NULL;
  1457. HRESULT hr = pCallStateEvent->get_Call(&pCallInfo);
  1459. if(NULL != pCallInfo &&  ( SUCCEEDED(hr) && NULL != m_pCall) )
  1460. {
  1461. bool bIsEqual = true;
  1462. //
  1463. // 比较两个 Call object 的 IUnknown 接口
  1464. //
  1465. IUnknown* pIUnkCallInfo = NULL;
  1466. IUnknown* pIUnkCallControl = NULL;
  1467. pCallInfo->QueryInterface(IID_IUnknown, (void**)&pIUnkCallInfo);
  1468. m_pCall->QueryInterface(IID_IUnknown, (void**)&pIUnkCallControl);
  1469. //
  1470. //比较
  1471. //
  1472. if(pIUnkCallInfo != pIUnkCallControl)
  1473. {
  1474. bIsEqual = false;
  1475. }
  1477. //
  1478. //释放内存
  1479. //
  1480. pCallInfo->Release();
  1481. if(NULL != pIUnkCallInfo)
  1482. {
  1483. pIUnkCallInfo->Release();
  1484. }
  1485. if(NULL != pIUnkCallControl)
  1486. {
  1487. pIUnkCallControl->Release();
  1488. }
  1489. return bIsEqual;
  1490. }
  1491. else
  1492. {
  1493. return false;
  1494. }
  1495. }
  1498. //////////////////////////////////////////////////////////////////
  1499. //
  1500. // GetTerminalFromStreamEvent 
  1501. //
  1502. // 功能：从 MediaEvent 事件中获得媒体流，然后，再由媒体流获得终端
  1503. // 如果对应的终端存在，则返回 NULL
  1504. //////////////////////////////////////////////////////////////////
  1505. HRESULT CTapi::GetTerminalFromStreamEvent( 
  1506. IN ITCallMediaEvent * pCallMediaEvent,
  1507.             OUT ITTerminal ** ppTerminal )
  1508. {
  1509.     HRESULT hr;
  1511. *ppTerminal = NULL;
  1512.     //
  1513.     // 获得这一事件当中的媒体流
  1514.     //
  1515.     ITStream * pStream;
  1516.     hr = pCallMediaEvent->get_Stream( &pStream );
  1517.     if ( FAILED(hr) || (pStream == NULL) ) return E_FAIL;
  1519.     //
  1520.     // 列举支持这一种媒体流的终端
  1521.     //
  1522.     IEnumTerminal * pEnumTerminal;
  1523.     hr = pStream->EnumerateTerminals( &pEnumTerminal );
  1524.     pStream->Release();
  1525.     if ( FAILED(hr) ) return hr;
  1527.     //
  1528. // 获得第一个终端，如果没有找到，返回 E_FAIL 跳出这一事件的处理
  1529.     //
  1530.     hr = pEnumTerminal->Next(1, ppTerminal, NULL);
  1531.     if ( hr != S_OK )
  1532.     {
  1533.         pEnumTerminal->Release();
  1534.         return E_FAIL;
  1535.     }
  1537.     //
  1538. // 进一步检测，注意这里不可能有大于一个终端，因为我们对每一各媒体流只选择
  1539. // 过一个终端
  1540.     //
  1542.     ITTerminal * pExtraTerminal;
  1543.     hr = pEnumTerminal->Next(1, &pExtraTerminal, NULL);
  1544.     pEnumTerminal->Release();
  1546.     if ( hr == S_OK ) // 大于一个终端，不可能出现的情况
  1547.     {
  1548.         pExtraTerminal->Release();
  1549.         (*ppTerminal)->Release();
  1550.         *ppTerminal = NULL;
  1551.         return E_UNEXPECTED;
  1552.     }
  1554.     return S_OK;
  1555. }