TSPI_providerCreateLineDevice函式 (tspi.h)

TAPI 會呼叫 TSPI_providerCreateLineDevice 函式，以回應從服務提供者接收 LINE_CREATE 訊息，以允許動態建立新的線路裝置。

語法

LONG TSPIAPI TSPI_providerCreateLineDevice(
  DWORD_PTR dwTempID,
  DWORD     dwDeviceID
);

參數

dwTempID

服務提供者在 LINE_CREATE 訊息中傳遞至 TAPI 的暫時裝置識別碼。

dwDeviceID

如果此函式成功，TAPI 指派給此裝置的裝置識別碼。

傳回值

如果要求成功，則傳回零，如果發生錯誤，則傳回錯誤號碼。 可能的傳回值為：

LINEERR_BADDEVICEID、LINEERR_NOMEM LINEERR_OPERATIONFAILED。

備註

當 TAPI 從服務提供者收到 LINE_CREATE 訊息時，它會呼叫此函式， (永遠不會) 呼叫此函式。 TAPI 會將 1 新增至該類型的裝置數目，並將產生的新未使用裝置識別碼當做 dwDeviceID 參數傳遞至此函式。 它也會將來自LINE_CREATE訊息的 dwParam2 參數傳入函式，作為 dwTempID。

注意 將新裝置新增至裝置清單結尾，可能會為服務提供者產生不連續的裝置識別碼;支援動態裝置建立的服務提供者也必須支援不連續的裝置識別碼。

 

如果服務提供者辨識 dwTempID 並成功設定結構，而且需要支援新裝置，則會省下 dwDeviceID，並傳回 SUCCESS。 如果此函式失敗，TAPI 不會新增裝置，而且 (忽略 LINE_CREATE 訊息) 沒有任何負面影響。 如果此函式順利完成，TAPI 接著會使用 LINE_CREATE 或 LINE_LINEDEVSTATE (LINEDEVSTATE_REINIT) 訊息通知應用程式新裝置的可用性。

不過，未匯出此函式的較舊服務提供者也不應該傳送LINE_CREATE訊息，這表示 TAPI 不會嘗試呼叫此函式。

規格需求

目標平台	Windows
標頭	tspi.h

另請參閱

LINE_CREATE

LINE_LINEDEVSTATE