phoneGetGain 函式 (tapi.h)

PhoneGetGain 函式會傳回所指定手機勾點裝置麥克風的取得設定。

語法

LONG phoneGetGain(
  HPHONE  hPhone,
  DWORD   dwHookSwitchDev,
  LPDWORD lpdwGain
);

參數

hPhone

開啟手機裝置的句柄。

dwHookSwitchDev

已查詢其增益等級的 Hookswitch 裝置。 dwHookSwitchDev 參數只能設定一個位。 此參數只會使用其中一個 PHONEHOOKSWITCHDEV_常數。

lpdwGain

DWORD 的指標，其中包含 hookswitch 麥克風元件的目前增益設定。 dwGain 參數會指定hookswitch裝置的音量層級。 這是0x00000000 (无声) 範圍中的數位，可0x0000FFFF (最大音量) 。 此範圍中取得設定的實際粒度和量化是服務提供者特定的。

傳回值

如果要求成功，則傳回零，如果發生錯誤，則傳回負錯誤號碼。 可能的傳回值為：

PHONEERR_INVALPHONEHANDLE、PHONEERR_NOMEM、PHONEERR_INVALPOINTER、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INVALPHONESTATE、PHONEERR_OPERATIONFAILED、PHONEERR_INVALHOOKSWITCHDEV、PHONEERR_UNINITIALIZED PHONEERR_OPERATIONUNAVAIL。

規格需求

另請參閱

補充電話服務功能

TAPI 2.2 參考概觀