функция TSPI_phoneGetStatus (tspi.h)
Функция TSPI_phoneGetStatus запрашивает у указанного открытого телефонного устройства его общее состояние.
Синтаксис
LONG TSPIAPI TSPI_phoneGetStatus(
HDRVPHONE hdPhone,
LPPHONESTATUS lpPhoneStatus
);
Параметры
hdPhone
Дескриптор запрашиваемого телефона.
lpPhoneStatus
Указатель на структуру данных изменчивого размера типа PHONESTATUS, в которую поставщик услуг записывает сведения о состоянии телефона. Перед вызовом TSPI_phoneGetStatus приложение задает член dwTotalSize этой структуры, чтобы указать объем памяти, доступный ДЛЯ TAPI для возврата сведений.
Возвращаемое значение
Возвращает ноль, если функция выполнена успешно, или номер ошибки при возникновении ошибки. Возможные возвращаемые значения:
PHONEERR_INVALPHONEHANDLE, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL PHONEERR_RESOURCEUNAVAIL.
Комментарии
В следующей таблице указано, какие элементы структуры данных PHONESTATUS заполняются TAPI, а какие — поставщиком услуг. Поставщик услуг не должен перезаписывать значения, заполненные TAPI.
| Член | TAPI | Поставщик службы |
|---|---|---|
| dwTotalSize; | X | |
| dwNeededSize; | X | |
| dwUsedSize; | X | |
| dwStatusFlags; | X | |
| dwNumOwners; | X | |
| dwNumMonitors; | X | |
| dwRingMode; | X | |
| dwRingVolume; | X | |
| dwHandsetHookSwitchMode; | X | |
| dwHandsetVolume; | X | |
| dwHandsetGain; | X | |
| dwSpeakerHookSwitchMode; | X | |
| dwSpeakerVolume; | X | |
| dwSpeakerGain; | X | |
| dwHeadsetHookSwitchMode; | X | |
| dwHeadsetVolume; | X | |
| dwHeadsetGain; | X | |
| dwDisplaySize; | X | |
| dwDisplayOffset; | X | |
| dwLampModesSize; | X | |
| dwLampModesOffset; | X | |
| dwOwnerNameSize; | X | |
| dwOwnerNameOffset; | X | |
| dwDevSpecificSize; | X | |
| dwDevSpecificOffset; | X |
TAPI может использовать эту функцию для определения текущего состояния открытого телефонного устройства. Сведения о состоянии описывают сведения о устройствах-перехватчиках телефонного устройства, звоня, громкости, дисплеях и лампах открытого телефона.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | tspi.h |