共用方式為

phoneSetGain 函式 (tapi.h)

  • 發行項

PhoneSetGain 函式會將指定勾點裝置的麥克風增益設定為指定的增益等級。

語法

LONG phoneSetGain(
  HPHONE hPhone,
  DWORD  dwHookSwitchDev,
  DWORD  dwGain
);

參數

hPhone

開啟手機裝置的句柄。 應用程式必須是手機的擁有者。

dwHookSwitchDev

要設定麥克風增益的攔截裝置。 此參數只會使用其中一個 PHONEHOOKSWITCHDEV_常數。

dwGain

包含裝置新增益設定的 DWORD 指標。 dwGain 參數會指定 hookswitch 裝置的增益層級。 這是0x00000000 (无声范围中的数字，) 0x0000FFFF (最大音量) 。 此範圍中取得設定的實際粒度和量化是服務提供者特定的。 超出範圍的 dwGain 值會設定為範圍中最接近的值。

傳回值

如果函式是以異步方式完成，則傳回正向要求標識符，如果發生錯誤，則傳回負錯誤號碼。 如果函式成功，則對應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

另請參閱

PHONE_REPLY

補充電話服務函式

TAPI 2.2 參考概觀