ASYNC_COMPLETION回呼函式 (tspi.h)

Completion_Proc 是由 TAPI 實作的回呼函式，並提供給服務提供者做為 參數來TSPI_providerInit。 服務提供者會呼叫此函式，以報告它以異步方式執行的線路或電話程式完成。

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

語法

ASYNC_COMPLETION AsyncCompletion;

void AsyncCompletion(
  DRV_REQUESTID dwRequestID,
  LONG lResult
)
{...}

參數

dwRequestID

在服務提供者以異步方式執行的原始要求中傳遞的標識碼。

lResult

作業的結果。 這可以是零，表示成功或負數表示錯誤。 異步或同步執行函式所產生的可能特定錯誤值相同。

傳回值

無

備註

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

當服務提供者使用 TSPI_providerInit 函式初始化時，TAPI 會提供此程式。 某些在線路、通話和電話裝置上運作的 TSPI 程式會指定異步操作。 這些程式包括用來識別要求的 dwRequestID 參數。 呼叫這類程式時，如果立即偵測到錯誤，服務提供者可能會傳回錯誤的負數，如果作業以異步方式繼續，則傳回正 dwRequestID 。 服務提供者必須針對異步執行的每個要求，只報告一次完成。 它會藉由呼叫這個程式來執行此動作。 除非這個程式傳回，否則服務提供者不允許再次呼叫此程式或 Line_Event 或 Phone_Event 程式。

服務提供者在從第一個要求傳回之前，允許呼叫 Completion_Proc 函式。 TAPI 保證不會從 Completion_Proc 內容中呼叫服務提供者，除非另有說明。

這在 TAPI 層級沒有任何直接對應，因為在該層級異步函式完成會回報為透過用於偵測事件訊息之相同回呼介面傳遞的訊息。 在 TSPI 層級，會透過 Line_Event 和 Phone_Event 回呼程式來報告Phone_Event事件。

規格需求

另請參閱

Line_Event

Phone_Event

TSPI_providerInit