共用方式為


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

另請參閱

LINEEVENT

LINE_CREATE

PHONEEVENT

PHONE_CREATE

TSPI_providerInit