Структура PHONESTATUS (tapi.h)
Структура PHONESTATUS описывает текущее состояние телефонного устройства. Функции phoneGetStatus и TSPI_phoneGetStatus возвращают эту структуру.
Синтаксис
typedef struct phonestatus_tag {
DWORD dwTotalSize;
DWORD dwNeededSize;
DWORD dwUsedSize;
DWORD dwStatusFlags;
DWORD dwNumOwners;
DWORD dwNumMonitors;
DWORD dwRingMode;
DWORD dwRingVolume;
DWORD dwHandsetHookSwitchMode;
DWORD dwHandsetVolume;
DWORD dwHandsetGain;
DWORD dwSpeakerHookSwitchMode;
DWORD dwSpeakerVolume;
DWORD dwSpeakerGain;
DWORD dwHeadsetHookSwitchMode;
DWORD dwHeadsetVolume;
DWORD dwHeadsetGain;
DWORD dwDisplaySize;
DWORD dwDisplayOffset;
DWORD dwLampModesSize;
DWORD dwLampModesOffset;
DWORD dwOwnerNameSize;
DWORD dwOwnerNameOffset;
DWORD dwDevSpecificSize;
DWORD dwDevSpecificOffset;
DWORD dwPhoneFeatures;
} PHONESTATUS, *LPPHONESTATUS;
Члены
dwTotalSize
Общий размер, выделенный для этой структуры данных, в байтах.
dwNeededSize
Размер этой структуры данных, необходимый для хранения всей возвращаемой информации, в байтах.
dwUsedSize
Размер части этой структуры данных, содержащей полезную информацию, в байтах.
dwStatusFlags
Флаги состояния для этого устройства телефона. Этот элемент использует одну из констант PHONESTATUSFLAGS_.
dwNumOwners
Количество модулей приложений с правами владельца для телефона.
dwNumMonitors
Количество модулей приложений с правами монитора для телефона.
dwRingMode
Текущий режим звонка на телефонном устройстве.
dwRingVolume
Текущий объем звонка телефонного устройства. Это значение между 0x00000000 (тишина) и 0x0000FFFF (максимальный объем).
dwHandsetHookSwitchMode
Текущий режим перехватчика телефона. Этот элемент использует одну из констант PHONEHOOKSWITCHMODE_.
dwHandsetVolume
Текущий громкость динамиков телефонного устройства телефона. Это значение между 0x00000000 (тишина) и 0x0000FFFF (максимальный объем).
dwHandsetGain
Текущее увеличение микрофона телефонного устройства телефона. Это значение между 0x00000000 (тишина) и 0x0000FFFF (максимальное увеличение).
dwSpeakerHookSwitchMode
Текущий режим перехватчика громкой связи телефона. Этот элемент использует одну из констант PHONEHOOKSWITCHMODE_.
dwSpeakerVolume
Текущий громкость динамиков громкоговорителя телефона. Это значение между 0x00000000 (тишина) и 0x0000FFFF (максимальный объем).
dwSpeakerGain
Текущее увеличение микрофона динамиков телефона. Это значение между 0x00000000 (тишина) и 0x0000FFFF (максимальное увеличение).
dwHeadsetHookSwitchMode
Текущий режим перехватчика гарнитуры телефона. Этот элемент использует одну из констант PHONEHOOKSWITCHMODE_.
dwHeadsetVolume
Текущий громкость динамиков гарнитуры телефона. Это значение между 0x00000000 (тишина) и 0x0000FFFF (максимальный объем).
dwHeadsetGain
Текущее увеличение микрофона устройства гарнитуры телефона. Это значение между 0x00000000 (тишина) и 0x0000FFFF (максимальное увеличение).
dwDisplaySize
Размер отображаемой информации в байтах.
dwDisplayOffset
Смещение от начала этой структуры до поля изменяющегося размера, содержащего текущую отображаемую информацию телефона. Размер поля определяется параметром dwDisplaySize.
dwLampModesSize
Размер массива текущих режимов лампочки в байтах.
dwLampModesOffset
Смещение от начала этой структуры до поля изменчивого размера, содержащего текущие режимы лампы телефона. Размер поля определяется параметром dwLampModesSize.
dwOwnerNameSize
Размер имени текущего владельца, включая признак конца null , в байтах.
dwOwnerNameOffset
Смещение от начала структуры до поля изменяющегося размера, содержащего имя приложения, являющегося текущим владельцем телефонного устройства. Имя — это имя приложения, предоставленное приложением при вызове с помощью phoneInitialize или phoneInitializeEx. Если имя приложения не указано, вместо него используется имя файла приложения. Размер поля определяется параметром dwOwnerNameSize. Если у телефона в настоящее время нет владельца, значение dwOwnerNameSize равно нулю.
dwDevSpecificSize
Размер поля для конкретного устройства в байтах. Если сведения, относящиеся к устройству, являются указателем на строку, размер должен включать признак конца null .
dwDevSpecificOffset
Смещение от начала этой структуры к полю устройства изменяющегося размера. Размер поля определяется dwDevSpecificSize.
dwPhoneFeatures
Флаги, указывающие, какие функции API телефонии можно вызывать на телефоне, учитывая доступность функции в возможностях устройства, текущее состояние устройства и владение устройством вызывающего приложения. Ноль указывает, что соответствующая функция не может быть вызвана приложением на телефоне в текущем состоянии; значение , указывающее, что компонент можно вызвать. Этот элемент использует одну или несколько констант PHONEFEATURE_.
Комментарии
Расширения, относящиеся к устройству, должны использовать область DevSpecific (dwDevSpecificSize и dwDevSpecificOffset) с разными размерами этой структуры данных.
Член dwPhoneFeatures доступен только для приложений, которые открывают телефонное устройство с API версии 2.0 или более поздней.
Требования
| Требование | Значение |
|---|---|
| Заголовок | tapi.h |