lineDevSpecificFeature 函式 (tapi.h)
lineDevSpecificFeature 函式可讓服務提供者存取其他 TAPI 函式未提供的功能。 這些延伸模組的意義是裝置特定的,而且利用這些擴充功能需要應用程式完全了解它們。
語法
LONG lineDevSpecificFeature(
HLINE hLine,
DWORD dwFeature,
LPVOID lpParams,
DWORD dwSize
);
參數
hLine
線條裝置的句柄。
dwFeature
在線路裝置上叫用的功能。 此參數會使用 PHONEBUTTONFUNCTION_ 常數。
lpParams
用來保存功能相依參數區塊的記憶體區域指標。 此參數區塊的格式是裝置特定,而且其內容會由TAPI傳遞至服務提供者或從服務提供者傳遞。
dwSize
緩衝區的大小,以位元組為單位。
傳回值
如果函式是以異步方式完成,則傳回正要求標識碼,如果發生錯誤,則傳回負錯誤號碼。 如果函式成功或發生錯誤,則對應LINE_REPLY訊息的 dwParam2 參數為零。 可能的傳回值為:
LINEERR_INVALFEATURE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALLINEHANDLE、LINEERR_OPERATIONFAILED、LINEERR_INVALPOINTER、LINEERR_RESOURCEUNAVAIL、LINEERR_NOMEM、LINEERR_UNINITIALIZED。
其他傳回值是裝置特定值。
備註
這項作業是擴充電話語音服務的一部分。 它提供裝置特定功能的存取權,而不需要定義其意義。 只有在應用程式已成功交涉裝置特定的擴充功能版本時,才能使用此作業。
此函式提供具有手機功能按鈕模擬功能的應用程式。 當應用程式叫用這項作業時,它會指定按鈕按下事件的對等專案。 叫用功能的這個方法相依於裝置,因為 TAPI 不會定義其意義。 一般而言,依賴這些裝置特定延伸模組的應用程式不適用於其他服務提供者環境。
lpParams 所指向的結構不應包含任何指標,因為它們在 32 位版本的 TAPI 中執行 16 位應用程式時,不會正確轉譯 (thunked) ,反之亦然。
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | tapi.h |
程式庫 | Tapi32.lib |
Dll | Tapi32.dll |