TSPI_providerEnumDevices 函数 (tspi.h)

TAPI 在TSPI_providerInit之前调用 TSPI_providerEnumDevices 函数,以确定服务提供商支持的线路和电话设备数。

语法

LONG TSPIAPI TSPI_providerEnumDevices(
  DWORD      dwPermanentProviderID,
  LPDWORD    lpdwNumLines,
  LPDWORD    lpdwNumPhones,
  HPROVIDER  hProvider,
  LINEEVENT  lpfnLineCreateProc,
  PHONEEVENT lpfnPhoneCreateProc
);

参数

dwPermanentProviderID

正在初始化的服务提供商在此系统上的服务提供程序中唯一的永久标识符。

lpdwNumLines

指向 DWORD 大小的内存位置的指针,服务提供商必须在其中写入配置为支持的行设备数。 TAPI 将值初始化为 0,因此,如果服务提供商无法写入其他值,则假定值 0。

lpdwNumPhones

指向 DWORD 大小的内存位置的指针,服务提供商必须在其中写入它配置为支持的电话设备数。 TAPI 将值初始化为 0,因此,如果服务提供商无法写入其他值,则假定值 0。

hProvider

一个不透明的 DWORD 大小的值,在电话环境执行期间唯一标识此服务提供程序的此实例。

lpfnLineCreateProc

指向 TAPI 提供的 LINEEVENT 回调过程的指针。 当需要创建新线路设备时,服务提供商使用此函数发送 LINE_CREATE 消息。

lpfnPhoneCreateProc

指向 TAPI 提供的 PHONEEVENT 回调过程的指针。 当需要创建新的电话设备时,服务提供商使用此函数发送 PHONE_CREATE 消息。

返回值

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

LINEERR_NOMEM、LINEERR_OPERATIONFAILED。

注解

在以前版本的 TAPI 中,此函数的实现是可选的。 从 TAPI 2.0 开始,必须在所有服务提供商中实现此函数。 TAPI 不再在 TAPI 启动时检查 Telephon.ini 或注册表,以确定服务提供商支持的初始线路数和电话数。

新设备可以在 完成TSPI_providerInit 过程之前出现。 TAPI 在提供程序初始化期间正确处理任何_CREATE消息。

要求

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

另请参阅

LINEEVENT

LINE_CREATE

PHONEEVENT

PHONE_CREATE

TSPI_providerInit