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 |