функция TSPI_lineGetDevCaps (tspi.h)

Статья
08/26/2023

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

Синтаксис

LONG TSPIAPI TSPI_lineGetDevCaps(
  DWORD         dwDeviceID,
  DWORD         dwTSPIVersion,
  DWORD         dwExtVersion,
  LPLINEDEVCAPS lpLineDevCaps
);

Параметры

dwDeviceID

Устройство строки для запроса.

dwTSPIVersion

Согласованный номер версии TSPI. Это значение уже согласовано для этого устройства с помощью функции TSPI_lineNegotiateTSPIVersion .

dwExtVersion

Согласованный номер версии расширения. Это значение уже согласовано для этого устройства с помощью функции TSPI_lineNegotiateExtVersion . Этот параметр не проверяется TAPI при вызове этой функции.

lpLineDevCaps

Указатель на структуру изменчивого размера типа LINEDEVCAPS. После успешного выполнения запроса эта структура заполняется сведениями о возможностях линейного устройства.

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

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

LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_OPERATIONUNAVAIL, LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_OPERATIONFAILED, LINEERR_NODRIVER, LINEERR_RESOURCEUNAVAIL LINEERR_NOMEM.

Нумерация строковых идентификаторов устройств для поставщика услуг выполняется последовательно по значению, заданному параметром dwLineDeviceIDBase , который передается в функцию TSPI_providerInit .

Формальный параметр dwExtVersion указывает номер версии запрошенных сведений о расширении. Если значение равно нулю, информация о расширении не запрашивается. Если это ненулевое значение, оно содержит значение, согласованное для этого устройства с помощью функции TSPI_lineNegotiateExtVersion . Поставщик услуг заполняет расширенные сведения о конкретном устройстве и поставщике в соответствии с указанной версией расширения.

Поставщик услуг заполняет все элементы структуры данных LINEDEVCAPS , за исключением dwTotalSize, которая заполняется с помощью TAPI. Поставщик услуг не должен перезаписывать член dwTotalSize .

Поставщик услуг должен заполнить все элементы структуры данных LINETERMCAPS или структур, внедренных в разную часть структуры данных LINEDEVCAPS .

После возврата поставщика услуг из функции TSPI_lineGetDevCaps TAPI задает член dwLinesStates структуры LINEDEVCAPS следующим образом:

LINEDEVCAPS.dwLineStates |=
    LINEDEVSTATE_OPEN |
    LINEDEVSTATE_CLOSE |
    LINEDEVSTATE_REINIT |
    LINEDEVSTATE_TRANSLATECHANGE;

Требования

Требование	Значение
Целевая платформа	Windows
Header	tspi.h

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

LINEDEVCAPS

LINETERMCAPS

TSPI_lineNegotiateExtVersion

TSPI_lineNegotiateTSPIVersion

TSPI_providerInit

Share via