事件 (电话服务 API)

事件是 TAPI 3 下呼叫处理的关键部分。 事件处理包括四个阶段。

注册并启用事件接收

  1. 实现 ITTAPIEventNotification::Event 方法。 (TAPI 在事件发生时调用此方法。) 通常,此实现只执行 AddRef IDispatch 接口指针,然后发布到应用程序的消息泵。

  2. 使用 COM 标准 IConnectionPointContainer 和 IConnectionPoint 接口注册 ITTAPIEventNotification 传出接口,并将 IConnectionPoint::Advise 方法传递给 ITTAPIEventNotification::Event 的指针。

  3. 调用 ITTAPI::p ut_EventFilter 方法以告知 TAPI 应用程序将处理哪些事件。 事件筛选器由 TAPI_EVENT 枚举的 ORed 成员组成。

    注意

    必须调用 ITTAPI::p ut_EventFilter 方法来设置事件筛选器掩码并启用事件接收。 如果不调用 ITTAPI::p ut_EventFilter,应用程序将不会收到任何事件。

     

还必须为应用程序将处理调用的每个地址对象调用 ITTAPI::RegisterCallNotifications 方法。

有关所有 事件接口 的列表,请参阅事件接口。 有关演示注册过程的代码示例和接收呼叫的代码示例,请参阅注册事件,获取显示事件的一种用法的代码示例。