phoneSetHookSwitch 函式 (tapi.h)
phoneSetHookSwitch 函式會將所指定開啟手機攔截裝置的攔截狀態設定為指定的模式。 只會影響所列出的 hookswitch 裝置的 hookswitch 狀態。
語法
LONG phoneSetHookSwitch(
HPHONE hPhone,
DWORD dwHookSwitchDevs,
DWORD dwHookSwitchMode
);
參數
hPhone
開啟手機裝置的句柄。 應用程式必須是手機的擁有者。
dwHookSwitchDevs
要設定攔截模式的裝置。 此參數只會使用其中一個 PHONEHOOKSWITCHDEV_常數。
PHONEHOOKSWITCHDEV_HANDSET
手機的手部。
PHONEHOOKSWITCHDEV_SPEAKER
手機的喇叭或輔助電話。
PHONEHOOKSWITCHDEV_HEADSET
手機的頭戴式裝置。
dwHookSwitchMode
要設定的 Hookswitch 模式。 此參數只會使用其中一個 PHONEHOOKSWITCHMODE_常數。
PHONEHOOKSWITCHMODE_ONHOOK
裝置的麥克風和喇叭都是 onhook。
PHONEHOOKSWITCHMODE_MIC
裝置的麥克風處於作用中狀態，喇叭會設為靜音。
PHONEHOOKSWITCHMODE_SPEAKER
裝置的喇叭為使用中，麥克風為靜音。
PHONEHOOKSWITCHMODE_MICSPEAKER
裝置的麥克風和喇叭都處於作用中狀態。
傳回值
如果函式是以異步方式完成，則傳回正要求標識碼，如果發生錯誤，則傳回負錯誤號碼。 如果函式成功，則對應PHONE_REPLY訊息的 dwParam2 參數為零，如果發生錯誤，則為負錯誤號碼。 可能的傳回值為：
PHONEERR_INVALPHONEHANDLE、PHONEERR_OPERATIONUNAVAIL、PHONEERR_NOTOWNER、PHONEERR_NOMEM、PHONEERR_INVALHOOKSWITCHDEV、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INVALHOOKSWITCHMODE、PHONEERR_OPERATIONFAILED、PHONEERR_INVALPHONESTATE PHONEERR_UNINITIALIZED。
備註
所有指定裝置的攔截模式都相同。 如果需要不同的設定，可以使用一組不同的參數多次叫用此函式。 PHONE_STATE訊息會在 hookswitch 狀態變更之後傳送至應用程式。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | tapi.h |
| 程式庫 | Tapi32.lib |
| Dll | Tapi32.dll |