функция TSPI_lineGetAddressCaps (tspi.h)
Функция TSPI_lineGetAddressCaps запрашивает указанный адрес на указанном устройстве линии, чтобы определить его возможности телефонии.
Синтаксис
LONG TSPIAPI TSPI_lineGetAddressCaps(
DWORD dwDeviceID,
DWORD dwAddressID,
DWORD dwTSPIVersion,
DWORD dwExtVersion,
LPLINEADDRESSCAPS lpAddressCaps
);
Параметры
dwDeviceID
Устройство строки, содержащее адрес для запроса.
dwAddressID
Адрес на данном устройстве линии, возможности которого необходимо запрашивать. Идентификатор адреса постоянно связан с адресом; идентификатор остается неизменным при обновлении операционной системы. Этот параметр не проверяется TAPI при вызове этой функции.
dwTSPIVersion
Номер версии используемого spi-подключения телефонии. Слово высокого порядка содержит основной номер версии; слово нижнего порядка содержит дополнительный номер версии.
dwExtVersion
Номер версии используемых расширений поставщика услуг. Это число равно нулю, если не требуется использовать расширения для конкретного устройства. В противном случае слово высокого порядка содержит основной номер версии; слово нижнего порядка содержит дополнительный номер версии. Этот параметр не проверяется TAPI при вызове этой функции.
lpAddressCaps
Указатель на структуру изменчивого размера типа LINEADDRESSCAPS. После успешного выполнения запроса эта структура заполняется сведениями о возможностях адресов.
Возвращаемое значение
Возвращает ноль, если функция выполнена успешно, или номер ошибки при возникновении ошибки. Возможные возвращаемые значения:
LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_NOMEM, LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESSID, LINEERR_OPERATIONFAILED, LINEERR_NODRIVER LINEERR_RESOURCEUNAVAIL.
Комментарии
Идентификаторы устройств строки, поддерживаемые определенным драйвером, нумеруются последовательно, начиная со значения dwLineDeviceIDBase , которое передается в функцию TSPI_providerInit .
Поставщик услуг заполняет все элементы структуры данных LINEADDRESSCAPS , за исключением dwTotalSize, которая заполняется с помощью TAPI. Поставщик услуг не должен перезаписывать член dwTotalSize .
После того как поставщик услуг возвращается из функции TSPI_lineGetAddressCaps , TAPI задает элементы dwCallInfoStates и dwCallStates структуры LINEADDRESSCAPS следующим образом:
LINEADDRESSCAPS.dwCallInfoStates |=
LINECALLINFOSTATE_NUMOWNERINCR |
LINECALLINFOSTATE_NUMOWNERDECR |
LINECALLINFOSTATE_NUMMONITORS;
LINEADDRESSCAPS.dwCallStates |= LINECALLSTATE_UNKNOWN;
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | tspi.h |