phoneGetGain 函数 (tapi.h)

phoneGetGain 函数返回指定手机的挂钩开关设备的麦克风的增益设置。

语法

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

参数

hPhone

打开的手机设备的句柄。

dwHookSwitchDev

查询其增益级别的挂钩开关设备。 dwHookSwitchDev 参数只能设置一个位。 此参数只使用一个 PHONEHOOKSWITCHDEV_常量

lpdwGain

指向包含挂钩开关麦克风组件的当前增益设置的 DWORD 的指针。 dwGain 参数指定 hookswitch 设备的卷级别。 这是) 0x00000000 (最大音量) 0x0000FFFF (范围内的数字。 此范围内增益设置的实际粒度和量化是特定于服务提供程序的。

返回值

如果请求成功,则返回零;如果发生错误,则返回负错误号。 可能的返回值为:

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

要求

要求
目标平台 Windows
标头 tapi.h
Library Tapi32.lib
DLL Tapi32.dll

另请参阅

补充电话服务函数

TAPI 2.2 参考概述