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 元素,以接收所有显示信息。 dwDisplayNumRows 和 dwDisplayNumColumns 成员在TSPI_phoneGetDevCaps返回的 PHONECAPS 结构中可用。
服务提供商将填充 VARSTRING 数据结构的所有成员, dwTotalSize 除外,后者由 TAPI 填充。 服务提供程序不得覆盖 dwTotalSize 成员。
要求
目标平台 | Windows |
标头 | tspi.h |