TSPI_providerCreateLineDevice 函数 (tspi.h)

TSPI_PROVIDERCREATELINEDEVICE函数由 TAPI 调用,以响应从服务提供商收到LINE_CREATE消息,从而允许动态创建新线路设备。

语法

LONG TSPIAPI TSPI_providerCreateLineDevice(
  DWORD_PTR dwTempID,
  DWORD     dwDeviceID
);

参数

dwTempID

服务提供商在 LINE_CREATE 消息中传递给 TAPI 的临时设备标识符。

dwDeviceID

如果此函数成功,TAPI 分配给此设备的设备标识符。

返回值

如果请求成功,则返回零;如果发生错误,则返回错误号。 可能的返回值为:

LINEERR_BADDEVICEID、LINEERR_NOMEM、LINEERR_OPERATIONFAILED。

注解

当 TAPI 从服务提供商收到 LINE_CREATE 消息时,它会调用此函数, (它永远不会自发地) 调用此函数。 TAPI 将 1 添加到该类型的设备数,并将生成的新的未使用设备标识符作为 dwDeviceID 参数传递给此函数。 它还将来自LINE_CREATE消息的 dwParam2 参数作为 dwTempID 传入函数。

注意 将新设备添加到设备列表的末尾可能会生成服务提供商的非连续设备标识符;支持动态设备创建的服务提供商还必须支持不连续的设备标识符。
 
如果服务提供商识别 dwTempID 并成功设置结构,因此需要支持新设备,则会保存 dwDeviceID,并返回 SUCCESS。 如果此函数不成功,TAPI 不会添加设备,并且不会 (忽略 LINE_CREATE 消息) 没有负面影响。 如果此函数成功完成,TAPI 将使用LINE_CREATE或 LINE_LINEDEVSTATE (LINEDEVSTATE_REINIT) 消息通知应用程序新设备的可用性。

但是,不导出此函数的旧服务提供商也不应发送LINE_CREATE消息,这意味着 TAPI 不会尝试调用此函数。

要求

   
目标平台 Windows
标头 tspi.h

另请参阅

LINE_CREATE

LINE_LINEDEVSTATE