lineDevSpecific 函式 (tapi.h)

  • 發行項

lineDevSpecific函式可讓服務提供者存取其他 TAPI 函式未提供的功能。 擴充功能的意義是裝置專屬的，而且利用這些擴充功能需要應用程式完全瞭解它們。

語法

LONG lineDevSpecific(
  HLINE  hLine,
  DWORD  dwAddressID,
  HCALL  hCall,
  LPVOID lpParams,
  DWORD  dwSize
);

參數

hLine

線條裝置的控制碼。 此為必要參數。

dwAddressID

指定行裝置上的位址識別碼。 位址識別碼會永久與位址相關聯;識別碼在作業系統升級期間會維持不變。

hCall

呼叫的控制碼。 此參數是選擇性的，但如果已指定，則它所代表的呼叫必須屬於 hLine 線路裝置。 hCall的撥號狀態為裝置特定。

lpParams

用來保存參數區塊之記憶體區域的指標。 此參數區塊的格式是裝置特定，而且其內容會由 TAPI 傳遞至服務提供者或從服務提供者傳遞。

dwSize

參數區塊區域的大小，以位元組為單位。

傳回值

如果函式是以非同步方式完成，則傳回正要求識別碼，如果發生錯誤，則傳回負錯誤號碼。 如果函式成功，則對應LINE_REPLY訊息的dwParam2參數為零，如果發生錯誤，則為負錯誤號碼。 可能的傳回值為：

LINEERR_INVALADDRESSID、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONFAILED、LINEERR_INVALLINEHANDLE、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALPOINTER、LINEERR_UNINITIALIZED LINEERR_NOMEM。

其他傳回值是裝置特定的值。

備註

這項作業是擴充電話語音服務的一部分。 它提供裝置特定功能的存取權，而不需要定義其意義。 只有在應用程式已成功交涉裝置特定擴充功能版本時，才能使用此作業。

此函式提供泛型參數設定檔。 參數結構的解譯是裝置特定的。 dwAddressID和/或hCall是否預期有效是裝置特定。 如果指定，它們必須屬於 hLine。 傳送回裝置特定應用程式的指示和回復應該使用 LINE_DEVSPECIFIC 訊息。

服務提供者可以藉由定義參數來搭配此函式使用，以提供裝置特定函式的存取權。 若應用程式想要使用這些裝置特定擴充功能，則應該參閱裝置特定的 (，在此案例中，廠商特定的) 檔會說明所定義的擴充功能。 一般而言，依賴這些裝置特定擴充功能的應用程式無法與其他服務提供者環境搭配使用。

謹慎 TAPI 會在傳回LINE_REPLY訊息時，將傳回的資料寫入 lParam 所參考的緩衝區。 這表示緩衝區必須維持有效狀態，直到傳回LINE_REPLY訊息為止;否則，可能會發生資料損毀和例外狀況。
 

規格需求

   
目標平台 Windows
標頭 tapi.h
程式庫 Tapi32.lib
Dll Tapi32.dll

另請參閱

擴充電話語音服務參考

LINE_DEVSPECIFIC

LINE_REPLY

TAPI 2.2 參考概觀