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 |