phoneSetHookSwitch 函数 (tapi.h)

项目
08/26/2023

phoneSetHookSwitch 函数将指定打开手机的挂钩开关设备的挂钩状态设置为指定模式。只有列出的挂钩开关设备的挂钩开关状态才会受到影响。

语法

LONG phoneSetHookSwitch(
  HPHONE hPhone,
  DWORD  dwHookSwitchDevs,
  DWORD  dwHookSwitchMode
);

参数

hPhone

打开的手机设备的句柄。应用程序必须是电话的所有者。

dwHookSwitchDevs

要设置挂钩开关模式的设备。此参数使用一个且只使用一个 PHONEHOOKSWITCHDEV_常量。

PHONEHOOKSWITCHDEV_HANDSET

手机的手机。

PHONEHOOKSWITCHDEV_SPEAKER

手机的免提电话或辅助电话。

PHONEHOOKSWITCHDEV_HEADSET

手机的头戴显示设备。

dwHookSwitchMode

要设置的挂钩切换模式。此参数使用一个且只使用一个 PHONEHOOKSWITCHMODE_常量。

PHONEHOOKSWITCHMODE_ONHOOK

设备的麦克风和扬声器都处于 onhook。

PHONEHOOKSWITCHMODE_MIC

设备的麦克风处于活动状态，扬声器静音。

PHONEHOOKSWITCHMODE_SPEAKER

设备的扬声器处于活动状态，麦克风静音。

PHONEHOOKSWITCHMODE_MICSPEAKER

设备的麦克风和扬声器都处于活动状态。

返回值

如果异步完成函数，则返回正请求标识符;如果发生错误，则返回负错误号。如果函数成功，则相应PHONE_REPLY消息的 dwParam2 参数为零;如果发生错误，则为负错误数。可能的返回值为：

PHONEERR_INVALPHONEHANDLE、PHONEERR_OPERATIONUNAVAIL、PHONEERR_NOTOWNER、PHONEERR_NOMEM、PHONEERR_INVALHOOKSWITCHDEV、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INVALHOOKSWITCHMODE、PHONEERR_OPERATIONFAILED、PHONEERR_INVALPHONESTATE、PHONEERR_UNINITIALIZED。

注解

挂钩切换模式对于所有指定的设备都是相同的。如果需要不同的设置，可以使用一组不同的参数多次调用此函数。挂钩开关状态更改后，会向应用程序发送 PHONE_STATE 消息。

要求

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

另请参阅

通过