ASYNC_COMPLETION回调函数 (tspi.h)

  • 项目

Completion_Proc 是由 TAPI 实现的回调函数，作为参数提供给服务提供商 TSPI_providerInit。 服务提供商调用此函数来报告其异步执行的线路或电话过程的完成情况。

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

语法

ASYNC_COMPLETION AsyncCompletion;

void AsyncCompletion(
  DRV_REQUESTID dwRequestID,
  LONG lResult
)
{...}

参数

dwRequestID

在服务提供程序异步执行的原始请求中传递的标识符。

lResult

操作的结果。 这可以是零表示成功，也可以是负数来表示错误。 函数可能产生的特定错误值对于异步或同步执行是相同的。

返回值

无

备注

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

此过程由 TAPI 在服务提供程序使用 TSPI_providerInit 函数初始化时提供。 一些在线路、呼叫和电话设备上运行的 TSPI 过程指定异步操作。 这些过程包括用于标识请求的 dwRequestID 参数。 调用此类过程时，如果立即检测到错误，则服务提供商可以返回一个负数;如果操作以异步方式继续，则返回正 dwRequestID 。 对于以异步方式执行的每个请求，服务提供商必须只报告一次完成情况。 它通过调用此过程来执行此操作。 在此过程返回之前，不允许服务提供商再次调用此过程或 Line_Event 或 Phone_Event 过程。

允许服务提供商在从第一个请求返回 之前调用Completion_Proc 函数。 TAPI 保证不会从 Completion_Proc 上下文中调用服务提供商，除非另有说明。

这在 TAPI 级别没有任何直接对应关系，因为在该级别，异步函数完成报告为通过用于自发事件消息的同一回调接口传递的消息。 在 TSPI 级别，通过 Line_Event 和 Phone_Event 回调过程报告自发事件。

要求

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

另请参阅

Line_Event

Phone_Event

TSPI_providerInit