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。

規格需求

另請參閱

PHONE_REPLY

補充電話服務函式

TAPI 2.2 參考概觀