TSPI_phoneGetDisplay 函数 (tspi.h)

TSPI_phoneGetDisplay函数返回指定手机显示器的当前内容。

语法

LONG TSPIAPI TSPI_phoneGetDisplay(
  HDRVPHONE   hdPhone,
  LPVARSTRING lpDisplay
);

参数

hdPhone

要查询的电话的句柄。

lpDisplay

指向内存位置的指针,其中显示内容将由提供程序存储,类型为 VARSTRING。 在调用 TSPI_phoneGetDisplay 之前,应用程序设置此结构的 dwTotalSize 成员,以指示 TAPI 可用于返回信息的内存量。

返回值

如果函数成功,则返回零;如果发生错误,则返回错误号。 可能的返回值如下所示:

PHONEERR_INVALPHONEHANDLE、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INVALPHONESTATE、PHONEERR_OPERATIONFAILED、PHONEERR_NOMEM、PHONEERR_OPERATIONUNAVAIL。

注解

lpDisplay 内存区域的大小应至少为 dwDisplayNumRows * dwDisplayNumColumns 元素,以接收所有显示信息。 dwDisplayNumRowsdwDisplayNumColumns 成员在TSPI_phoneGetDevCaps返回的 PHONECAPS 结构中可用。

服务提供商将填充 VARSTRING 数据结构的所有成员, dwTotalSize 除外,后者由 TAPI 填充。 服务提供程序不得覆盖 dwTotalSize 成员。

要求

   
目标平台 Windows
标头 tspi.h

另请参阅

PHONECAPS

TSPI_phoneGetDevCaps

TSPI_phoneSetDisplay

VARSTRING