共用方式為


LINEEVENT 回呼函式 (tspi.h)

Line_Event 是由 TAPI 實作的回呼函式,並提供給服務提供者做為 參數來TSPI_lineOpen。 服務提供者會呼叫此函式來報告在行上發生的事件,或是在該行的呼叫上發生的事件。

LINEEVENT 類型會定義這個回呼函式的指標。 Line_Event 是應用程式定義函數名稱的佔位元。

語法

LINEEVENT Lineevent;

void Lineevent(
  HTAPILINE htLine,
  HTAPICALL htCall,
  DWORD dwMsg,
  DWORD_PTR dwParam1,
  DWORD_PTR dwParam2,
  DWORD_PTR dwParam3
)
{...}

參數

htLine

發生事件之行的 TAPI 句柄。

htCall

如果這是呼叫相關事件,就會發生事件的TAPI句柄。 對於沒有呼叫的行相關事件,此參數會設定為 NULL

dwMsg

指定所報告的事件種類。 根據 dwMsg 所指示的內容,以不同方式執行其他參數的解譯。

dwParam1

訊息的參數。

dwParam2

訊息的參數。

dwParam3

訊息的參數。

傳回值

備註

呼叫此函式時的呼叫狀態可以是任何狀態。

服務提供者會將提供給 TSPI_lineOpen的 HTAPILINE 值當做 htLine 參數傳遞。 其中包含事件特有的訊息標識碼和參數。

此函式與 TAPI 層級定義的回呼函式不同,因為它會分隔行和呼叫參數。 這兩個參數都用於某些訊息。 可以傳遞至此程式的訊息集與 TAPI 層級稍有不同。 特別是,透過 Completion_Proc 回呼來報告異步執行要求完成,而不是這個要求。

規格需求

需求
目標平台 Windows
標頭 tspi.h

另請參閱

Completion_Proc

TSPI_lineOpen