Поделиться через


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

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

Синтаксис

LONG phoneGetData(
  HPHONE hPhone,
  DWORD  dwDataID,
  LPVOID lpData,
  DWORD  dwSize
);

Параметры

hPhone

Дескриптор на открытое телефонное устройство.

dwDataID

Где на телефонном устройстве нужно отправить буфер.

lpData

Указатель на буфер памяти, куда нужно отправить данные.

dwSize

Размер буфера данных в байтах.

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

Возвращает ноль при успешном выполнении запроса или отрицательное число ошибки при возникновении ошибки. Возможные возвращаемые значения:

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALDATAID, PHONEERR_UNINITIALIZED PHONEERR_OPERATIONUNAVAIL.

Комментарии

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

Требования

Требование Значение
Целевая платформа Windows
Header tapi.h
Библиотека Tapi32.lib
DLL Tapi32.dll

См. также раздел

Дополнительные функции телефонной службы

Обзор справочника по TAPI 2.2