функция TSPI_lineGetDevCaps (tspi.h)
Функция 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 |