lineDevSpecificFeature 函数 (tapi.h)

lineDevSpecificFeature 函数使服务提供商能够访问其他 TAPI 函数未提供的功能。 这些扩展的含义特定于设备,利用这些扩展需要应用程序充分了解它们。

语法

LONG lineDevSpecificFeature(
  HLINE  hLine,
  DWORD  dwFeature,
  LPVOID lpParams,
  DWORD  dwSize
);

参数

hLine

线路设备的句柄。

dwFeature

在线路设备上调用的功能。 此参数使用 PHONEBUTTONFUNCTION_ 常量

lpParams

指向用于保存与功能相关的参数块的内存区域的指针。 此参数块的格式特定于设备,其内容由 TAPI 传递到服务提供商或从服务提供商传递。

dwSize

缓冲区的大小(以字节为单位)。

返回值

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

LINEERR_INVALFEATURE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALLINEHANDLE、LINEERR_OPERATIONFAILED、LINEERR_INVALPOINTER、LINEERR_RESOURCEUNAVAIL、LINEERR_NOMEM、LINEERR_UNINITIALIZED。

其他返回值特定于设备。

注解

此操作是扩展电话服务的一部分。 它提供对设备特定功能的访问权限,而无需定义其含义。 仅当应用程序已成功协商特定于设备的扩展版本时,此操作才可用。

此函数为应用程序提供手机功能按钮仿真功能。 当应用程序调用此操作时,它指定按钮按下事件的等效项。 这种调用功能的方法依赖于设备,因为 TAPI 不定义其含义。 通常,依赖于这些特定于设备的扩展的应用程序不适用于其他服务提供商环境。

lpParams 指向的结构不应包含任何指针,因为它们在 32 位版本的 TAPI 中运行 16 位应用程序时,不会正确转换 () ,反之亦然。

要求

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

另请参阅

扩展电话服务参考

LINE_REPLY

TAPI 2.2 参考概述