Поделиться через


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

Структура LINEMEDIACONTROLTONE описывает действие мультимедиа, выполняемое при обнаружении тона. Он используется в качестве записи в массиве. Функции lineSetMediaControl и TSPI_lineSetMediaControl используют эту структуру.

Синтаксис

typedef struct linemediacontroltone_tag {
  DWORD dwAppSpecific;
  DWORD dwDuration;
  DWORD dwFrequency1;
  DWORD dwFrequency2;
  DWORD dwFrequency3;
  DWORD dwMediaControl;
} LINEMEDIACONTROLTONE, *LPLINEMEDIACONTROLTONE;

Члены

dwAppSpecific

Используется приложением для добавления тегов в тон. При обнаружении этого сигнала значение члена dwAppSpecific передается обратно в приложение.

dwDuration

Длительность времени, в течение которого тон должен присутствовать перед обнаружением , в миллисекундах.

dwFrequency1

Первая частота тона, в герцах.

dwFrequency2

Вторая частота тона, в герцах.

dwFrequency3

Третья частота тона, в герцах. Если в тон требуется менее трех частот, для неиспользуемых частот следует использовать значение 0. Тон со всеми тремя частотами, равными нулю, интерпретируется как тишина и может использоваться для обнаружения тишины.

dwMediaControl

Действие управления мультимедиа. Этот элемент использует одну из констант LINEMEDIACONTROL_.

Комментарии

Эта структура не может быть расширена.

Структура LINEMEDIACONTROLTONE определяет тон кортежа <, действие> управления мультимедиа. Массив этих кортежей передается в функцию lineSetMediaControl для задания действий управления мультимедиа, активированных изменениями типов мультимедиа для данного вызова. При обнаружении изменения указанного типа мультимедиа вызывается соответствующее действие в потоке мультимедиа.

Тон со всеми частотами, равными нулю, соответствует тишине. Таким образом, приложение может отслеживать поток информации вызова для обеспечения тишины.

Требования

Требование Значение
Заголовок tapi.h

См. также раздел

TSPI_lineSetMediaControl

lineSetMediaControl