Heyyo SoftPhone API设计说明书2.pdfVIP

HEYYO SoftPhone API 设计说明书 Heyyo SoftPhone API 设计说明书 (V1.1) 香港启悦发展有限公司 第 1 页 共 9 页 HEYYO SoftPhone API 设计说明书 目录 一、引言 3 1.1 编写目的 3 1.2 更新时间 3 二、总体设计 3 三、注册的系统消息3 3.1 WM_PHONEAPI_REGISTER 4 3.2 WM_PHONEAPI_REGISTER_RESP 4 3.3 WM_PHONEAPI_AVAILABLE 5 四、从设备到HEYYO SOFTPHONE 的自定义事件 5 4.1 EVENT_PHONEAPI_SET_AUDIODEVICE 5 4.2 EVENT_PHONEAPI_USBDEVICE_STATE_CHANGE 5 4.3 EVENT_PHONEAPI_PRESS_KEY 6 4.4 EVENT_PHONEAPI_UNREGISTER 6 五、从HEYYO SOFTPHONE 到设备的自定义事件 7 5.1 EVENT_PHONEAPI_INFO_CHANGE 7 5.2 EVENT_PHONEAPI_SHUTDOWN 8 六、参数类型码表9 第 2 页 共 9 页 HEYYO SoftPhone API 设计说明书 一、引言 1.1 编写目的 本文档提供了和悦网络电话 API 接口说明，以供第三方应用程序使用，用于和悦网络 电话和硬件设备（例如USB Phone ）的交互。 1.2 更新时间 最后修订日期：2006- 12-07 版本号：v 1.1 二、总体设计 和悦网络电话应用程序和第三方应用程序以收发消息的方式进行通讯。 双方未成功注册之前，采用RegisterWindowMessage （Windows API ）注册的系统消息 进行交互，注册成功后，双方分别获取对方的窗口句柄，接下 的交互通过收发 WM_COPYDATA （Windows 消息）消息完成。 WM_COPYDATA 的 wParam 参数为发送方 的窗口句柄，lParam 为指向 COPYDATASTRUCT 结构的指针，COPYDATASTRUCT 定义如下： typedef struct tagCOPYDATASTRUCT { ULONG_PTR dwData; DWORD cbData; PVOID lpData; }COPYDATASTRUCT, *PCOPYDATASTRUCT; dwData ：事件码，标示传送的消息事件码。 lpData ：消息参数，采用多个相连的 类型 （1 字节）＋长度 （4 字节）＋值”的格式。 所有的参数类型码表见8 参数类型码表；事件码为100 的EVENT_PHONEAPI_INFO_CHANGE 事件除外，事件码EVENT_PHONEAPI_INFO_CHANGE 首先是一个字节的类型，然后再跟上 一个格式为 类型 （1 字节）＋长度 （4 字节）＋值”的内容。 cbData ：消息参数总长度，单位字节。 三、注册的系统消息 第三方程序使用Windows SDK――Regis