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 不再檢查 Telephon.ini 或 TAPI 啟動時的登錄,以判斷服務提供者所支援的初始行數和電話數目。
新的裝置可以在 完成TSPI_providerInit 程式之前出現。 TAPI 會在提供者初始化期間正確處理任何_CREATE訊息。
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | tspi.h |