TSPI 訊息
本節包含電話語音服務提供者介面 (TSPI) 中的訊息清單。 這些訊息是用來通知 TAPI 發生非同步事件，這些事件在服務提供者中經常發生。 服務提供者會呼叫 LINEEVENT 或 PHONEEVENT 回呼函式，視服務提供者是否線上路、通話或電話裝置上報告事件而定，將這些事件傳遞至 TAPI。 在以TSPI_lineOpen函式開啟行時，會提供在行或呼叫上發生的事件 LINEEVENT程式給服務提供者。 電話上發生的報告事件的 PHONEEVENT 程式會提供 TSPI_phoneOpen 函式。
TAPI 不請求這些行動事件，因為它們不是任何要求的直接回應。 這些事件與 TAPI 所提出要求完成的報告相反。 這類完成事件會透過 ASYNC_COMPLETION 回呼函式回報。
自然事件程序的參數設定檔包含參數，可識別要回報事件的相關物件， (電話、線路或通話) 。 識別的格式為不透明控制碼，其確切解譯不是由 TSPI 發佈。 TAPI 會在內部判斷這些不透明控制碼與其用來代表裝置的任何資料結構之間的關聯性。
適用于自然事件程序的參數設定檔也包含識別訊息類型的訊息參數。 每個訊息類型都有對應的定義，可決定所包含的控制碼，以及其他參數及其意義。 訊息出現在 TSPI 層級和 TAPI 層級的訊息之間有非常強的對應。 這些是對應的一般規則：
- 訊息集幾乎完全相同。 當訊息對應時，TSPI 層級會使用相同的訊息名稱和值。
- 出現在 TSPI 層級的控制碼是 TSPI 規格所定義的不透明類型。 這些類型 (及其解譯) 與 TAPI 層級的解譯不同，不過它們參考相同的裝置類別。 例如，當 TAPI 訊息包含 HLINE 控制碼時，對應的 TSPI 訊息通常會包含 HTAPILINE 控制碼。
- 沒有傳遞至回 呼的 dwCallbackInstance 資料。
- dwParam1、dwParam2和dwParam3參數通常與 TAPI 訊息的對應參數相同。
- 線條導向和呼叫導向的訊息會傳遞至與電話導向訊息不同的回呼程式。
針對每個訊息，本節會列出下列專案：
- 訊息的用途
- 傳遞此訊息的回呼程式
- 訊息參數的描述
- 關於使用訊息的選擇性批註
- 其他函式、訊息和資料結構的選擇性參考
- 比較此訊息與 TAPI 介面的選擇性批註
某些訊息可用來通知 TAPI 物件狀態的變更。 這些訊息提供 TAPI 不透明物件控制碼，以及哪些狀態專案已變更的指示。 TAPI 接著可以呼叫物件的適當「取得狀態」函式，以取得物件的完整狀態。
發生事件時，訊息可能或可能不會傳送至 TAPI。 對於某些事件種類，例如狀態變更，TAPI 會指定一組感興趣的狀態變更。 建議服務提供者將它報告的狀態變更訊息事件限制為此集合中包含的事件。 服務提供者不需要遵守此限制。 換句話說，其可能會報告比嚴格必要更多的變更。 不過，它應該嘗試觀察效能限制。
TSPI 層級不會使用LINE_REPLY訊息。 使用 ASYNC_COMPLETION 回呼回報非同步要求完成。
TSPI 層級不會使用PHONE_REPLY訊息。 使用 ASYNC_COMPLETION 回呼回報非同步要求完成。
如需詳細資訊，請參閱下列主題：