Функция phoneSetDisplay (tapi.h)

Статья
03/02/2024

Функция phoneSetDisplay приводит к отображению указанной строки на указанном открытом телефонном устройстве.

Синтаксис

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

Параметры

hPhone

Дескриптор на открытое телефонное устройство. Приложение должно быть владельцем телефона.

dwRow

Положение строки на дисплее, где должен отображаться новый текст.

dwColumn

Положение столбца на дисплее, в котором должен отображаться новый текст.

lpsDisplay

Указатель на расположение памяти, в котором хранится отображаемое содержимое. Отображаемые сведения должны иметь формат, указанный в элементе dwStringFormat структуры PHONECAPS , которая описывает возможности устройства телефона.

dwSize

Размер сведений, на которые указывает lpsDisplay, в байтах. Если параметр lpsDisplay является указателем на строку, размер должен включать признак конца null.

Возвращаемое значение

Возвращает положительный идентификатор запроса, если функция выполняется асинхронно, или отрицательный номер ошибки при возникновении ошибки. Параметр dwParam2 соответствующего сообщения PHONE_REPLY равен нулю при успешном выполнении функции или отрицательным номером ошибки при возникновении ошибки. Возможные возвращаемые значения:

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; они отсчитываются от нуля.