phoneSetVolume 函式 (tapi.h)
phoneSetVolume 函式會將指定勾點裝置的喇叭元件音量設定為指定的層級。
語法
LONG phoneSetVolume(
HPHONE hPhone,
DWORD dwHookSwitchDev,
DWORD dwVolume
);
參數
hPhone
開啟手機裝置的句柄。 應用程式必須是手機的擁有者。
dwHookSwitchDev
要設定喇叭音量的 Hookswitch 裝置，這是其中一個 PHONEHOOKSWITCHDEV_常數。
dwVolume
裝置的新磁碟區設定。 dwVolume 參數會指定hookswitch裝置的磁碟區層級。 這是0x00000000 (无声范围中的数字，) 0x0000FFFF (最大音量) 。 此範圍中磁碟區設定的實際粒度和量化是服務提供者特定的。 超出範圍的 dwVolume 值會設定為範圍中最接近的值。
傳回值
如果函式是以異步方式完成，則傳回正向要求標識符，如果發生錯誤，則傳回負錯誤號碼。 如果函式成功，則對應PHONE_REPLY訊息的 dwParam2 參數為零，如果發生錯誤，則為負錯誤號碼。 可能的傳回值為：
PHONEERR_INVALPHONEHANDLE、PHONEERR_NOMEM、PHONEERR_NOTOWNER、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INVALPHONESTATE、PHONEERR_OPERATIONFAILED、PHONEERR_INVALHOOKSWITCHDEV、PHONEERR_UNINITIALIZED、PHONEERR_OPERATIONUNAVAIL。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | tapi.h |
| 程式庫 | Tapi32.lib |
| Dll | Tapi32.dll |