phoneDevSpecific 函数 (tapi.h)

phoneDevSpecific 函数用作常规扩展机制,使电话 API 实现能够提供其他 TAPI 函数中未描述的功能。 这些扩展的含义特定于设备。

语法

LONG phoneDevSpecific(
  HPHONE hPhone,
  LPVOID lpParams,
  DWORD  dwSize
);

参数

hPhone

手机设备的句柄。

lpParams

指向用于保存参数块的内存区域的指针。 其解释特定于设备。 参数块的内容由 TAPI 向服务提供商传递或从服务提供商传递不变。

dwSize

参数块区域的大小(以字节为单位)。

返回值

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

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

其他返回值特定于设备。

注解

此操作提供泛型参数配置文件。 参数块的解释是特定于设备的。 特定于设备的指示和答复应使用 PHONE_DEVSPECIFIC 消息。

服务提供商可以通过定义用于此操作的参数来提供对设备特定函数的访问。 希望使用这些特定于设备的扩展的应用程序应查阅特定于设备的 (供应商特定的) 文档,其中描述了定义了哪些扩展。 通常,依赖于这些特定于设备的扩展的应用程序不可移植,无法与其他服务提供商环境一起使用。

要求

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

另请参阅

扩展电话服务参考

PHONE_DEVSPECIFIC

PHONE_REPLY

TAPI 2.2 参考概述