phoneSetDisplay 函数 (tapi.h)

项目
03/09/2024

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

语法

LONG phoneSetDisplay(
  HPHONE hPhone,
  DWORD  dwRow,
  DWORD  dwColumn,
  LPCSTR lpsDisplay,
  DWORD  dwSize
);

参数

hPhone

打开的手机设备的句柄。应用程序必须是电话的所有者。

dwRow

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

dwColumn

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

lpsDisplay

指向存储显示内容的内存位置的指针。显示信息必须采用 PHONECAPS 结构的 dwStringFormat 成员中指定的格式，该结构描述手机的设备功能。

dwSize

lpsDisplay 指向的信息的大小（以字节为单位）。如果 lpsDisplay 参数是指向字符串的指针，则大小必须包含 null 终止符。

返回值

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

PHONEERR_INVALPHONEHANDLE、PHONEERR_OPERATIONUNAVAIL、PHONEERR_NOTOWNER、PHONEERR_OPERATIONFAILED、PHONEERR_INVALPHONESTATE、PHONEERR_UNINITIALIZED、PHONEERR_INVALPOINTER、PHONEERR_NOMEM、PHONEERR_INVALPARAM、PHONEERR_RESOURCEUNAVAIL。

注解

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