LINEEVENT 回调函数 (tspi.h)

  • 项目

Line_Event 是由 TAPI 实现的回调函数，作为参数提供给服务提供商 以TSPI_lineOpen。 服务提供商调用此函数来报告在线路上发生的事件或线路上的调用时发生的事件。

LINEEVENT 类型定义指向此回调函数的指针。 Line_Event 是应用程序定义的函数名称的占位符。

语法

LINEEVENT Lineevent;

void Lineevent(
  HTAPILINE htLine,
  HTAPICALL htCall,
  DWORD dwMsg,
  DWORD_PTR dwParam1,
  DWORD_PTR dwParam2,
  DWORD_PTR dwParam3
)
{...}

参数

htLine

发生事件的行的 TAPI 句柄。

htCall

如果这是与呼叫相关的事件，则发生事件的呼叫的 TAPI 句柄。 对于没有调用的行相关事件，此参数设置为 NULL。

dwMsg

指定要报告的事件的类型。 根据 dwMsg 指示的上下文，以不同方式执行其他参数的解释。

dwParam1

消息的参数。

dwParam2

消息的参数。

dwParam3

消息的参数。

返回值

无

备注

调用此函数时的调用状态可以是任何状态。

服务提供商将提供给 TSPI_lineOpen 的 HTAPILINE 值作为 htLine 参数传递。 它包括特定于事件的消息标识符和参数。

此函数不同于 TAPI 级别定义的回调函数，因为它分隔了行参数和调用参数。 这两个参数都用于某些消息。 可传递到此过程的消息集与 TAPI 级别略有不同。 具体而言，异步执行请求的完成情况通过 Completion_Proc 回调而不是此回调报告。

要求

要求 值
目标平台 Windows
标头 tspi.h

另请参阅

Completion_Proc

TSPI_lineOpen