phoneDevSpecific 函式 (tapi.h)
phoneDevSpecific 函式可用來作為一般擴充機制,讓電話語音 API 實作提供其他 TAPI 函式中未描述的功能。 這些擴充功能的意義是裝置特定的。
語法
LONG phoneDevSpecific(
HPHONE hPhone,
LPVOID lpParams,
DWORD dwSize
);
參數
hPhone
手機裝置的句柄。
lpParams
用來保存參數區塊之內存區域的指標。 其解譯是裝置特定的。 TAPI 對服務提供者或從服務提供者傳遞參數區塊的內容會保持不變。
dwSize
參數區塊區域的大小,以位元組為單位。
傳回值
如果函式是以異步方式完成,則傳回正要求標識碼,如果發生錯誤,則傳回負錯誤號碼。 如果函式成功,則對應PHONE_REPLY訊息的 dwParam2 參數為零,如果發生錯誤,則為負錯誤號碼。 可能的傳回值為:
PHONEERR_INVALPHONEHANDLE、PHONEERR_NOMEM、PHONEERR_INVALPOINTER、PHONEERR_RESOURCEUNAVAIL、PHONEERR_OPERATIONUNAVAIL、PHONEERR_UNINITIALIZED PHONEERR_OPERATIONFAILED。
其他傳回值是裝置特定的值。
備註
這項作業提供泛型參數配置檔。 參數區塊的解譯是裝置特定的。 裝置專屬的指示和回復應該使用 PHONE_DEVSPECIFIC 訊息。
服務提供者可以藉由定義參數來搭配這項作業使用,以提供裝置特定函式的存取權。 想要使用這些裝置特定擴充功能的應用程式,應該參閱裝置特定的 (廠商特定) 檔,以描述所定義的擴充功能。 一般而言,依賴這些裝置特定擴充功能的應用程式無法移植到其他服務提供者環境。
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | tapi.h |
程式庫 | Tapi32.lib |
Dll | Tapi32.dll |