Функция lineGetLineDevStatus (tapi.h)
Функция lineGetLineDevStatus позволяет приложению запрашивать у указанного устройства открытой линии текущее состояние.
Синтаксис
LONG lineGetLineDevStatus(
HLINE hLine,
LPLINEDEVSTATUS lpLineDevStatus
);
Параметры
hLine
Дескриптор для запроса устройства с открытой линией.
lpLineDevStatus
Указатель на структуру данных изменяющегося размера типа LINEDEVSTATUS. После успешного выполнения запроса эта структура заполняется состоянием устройства строки. Перед вызовом lineGetLineDevStatus приложение должно задать элемент dwTotalSize этой структуры, чтобы указать объем памяти, доступный TAPI для возврата информации.
Возвращаемое значение
Возвращает ноль, если запрос выполнен успешно, или отрицательный номер ошибки при возникновении ошибки. Возможные возвращаемые значения:
LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NOMEM, LINEERR_UNINITIALIZED, LINEERR_OPERATIONFAILED LINEERR_OPERATIONUNAVAIL.
Комментарии
Приложение использует lineGetLineDevStatus для запроса текущего состояния строки к устройству строки. Эти сведения о состоянии применяются глобально ко всем адресам на устройстве линии. Используйте lineGetAddressStatus для определения сведений о состоянии определенного адреса в строке.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | tapi.h |
| Библиотека | Tapi32.lib |
| DLL | Tapi32.dll |