TSPI_providerCreatePhoneDevice 函数 (tspi.h)
TAPI 调用 TSPI_providerCreatePhoneDevice 函数以响应从服务提供商收到PHONE_CREATE消息，从而允许动态创建新电话设备。
语法
LONG TSPIAPI TSPI_providerCreatePhoneDevice(
DWORD_PTR dwTempID,
DWORD dwDeviceID
);
参数
dwTempID
服务提供商在 PHONE_CREATE 消息中传递给 TAPI 的临时设备标识符。
dwDeviceID
如果此函数成功，TAPI 分配给此设备的设备标识符。
返回值
如果请求成功，则返回零;如果发生错误，则返回错误号。 常量PHONEERR_可能的返回值为：
PHONEERR_BADDEVICEID、PHONEERR_NOMEM、PHONEERR_OPERATIONFAILED。
注解
当 TAPI 收到来自服务提供商 的PHONE_CREATE 消息时，它会调用此函数， (它永远不会自发地) 调用此函数。 TAPI 将 1 添加到该类型的设备数，并将生成的新的未使用设备标识符作为 dwDeviceID 参数传递给此函数。 它还将来自PHONE_CREATE消息的 dwParam2 参数作为 dwTempID 传入函数。 将新设备添加到设备列表的末尾可能会生成服务提供商的非连续设备标识符;支持动态设备创建的服务提供商还必须支持不连续的设备标识符。
如果服务提供商识别 dwTempID 参数并成功设置结构，并且需要支持新设备，则会保存 dwDeviceID，并返回 SUCCESS。 如果此函数不成功，TAPI 不会添加设备，并且不会 (忽略 PHONE_CREATE 消息) 没有负面影响。 如果此函数成功完成，TAPI 将使用PHONE_CREATE或 PHONE_STATE (PHONESTATE_REINIT) 消息通知应用程序新设备的可用性。
但是，不导出此函数的旧服务提供商也不应发送PHONE_CREATE消息，这意味着 TAPI 不会尝试调用此函数。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | Windows |
| 标头 | tspi.h |