Структура PHONESTATUS (tapi.h)

Статья
03/02/2024

Структура 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_.