TSPI_phoneSetDisplay 函数 (tspi.h)

项目
03/13/2024

TSPI_phoneSetDisplay函数会导致指定的字符串显示在指定的打开电话设备上。

语法

LONG TSPIAPI TSPI_phoneSetDisplay(
  DRV_REQUESTID dwRequestID,
  HDRVPHONE     hdPhone,
  DWORD         dwRow,
  DWORD         dwColumn,
  LPCWSTR       lpsDisplay,
  DWORD         dwSize
);

参数

dwRequestID

异步请求的标识符。

hdPhone

要显示字符串的电话的句柄。

dwRow

要在其中显示新文本的显示器上的行。

dwColumn

要显示新文本的显示器上的列位置。

lpsDisplay

指向存储显示内容的内存位置的指针。应用程序在手机的 PHONECAPS 结构中以指定为 dwStringFormat 的格式存储显示信息。

dwSize

lpDisplay 指向的信息的大小（包括 null 终止符）。

返回值

如果发生错误，则返回 dwRequestID 或错误号。如果函数成功，则相应ASYNC_COMPLETION的 lResult 实际参数为零;如果发生错误，则为错误号。可能的返回值如下所示：

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

注解

从指定位置开始，指定的显示信息将写入手机的显示器。此操作将覆盖以前显示的信息。如果信息量超过显示大小，则截断信息。可以显示的信息量最多 (dwNumRows * dwNumColumns) 元素的大小。 dwNumRows 和 dwNumColumns 成员在由 TSPI_phoneGetDevCaps 返回的 PHONECAPS 结构中可用;它们是从零开始的。