LINEMEDIACONTROLTONE-Struktur (tapi.h)

Die LINEMEDIACONTROLTONE-Struktur beschreibt eine Medienaktion, die ausgeführt werden soll, wenn ein Ton erkannt wurde. Sie wird als Eintrag in einem Array verwendet. Die Funktionen lineSetMediaControl und TSPI_lineSetMediaControl verwenden diese Struktur.

Syntax

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

Member

dwAppSpecific

Wird von der Anwendung zum Markieren des Tones verwendet. Wenn dieser Ton erkannt wird, wird der Wert des dwAppSpecific-Elements an die Anwendung zurückgegeben.

dwDuration

Dauer der Zeit, in der der Ton vor einer Erkennung vorhanden sein sollte, in Millisekunden.

dwFrequency1

Erste Frequenz des Tons, in Hertz.

dwFrequency2

Zweite Frequenz des Tons in Hertz.

dwFrequency3

Dritte Frequenz des Tons in Hertz. Wenn weniger als drei Frequenzen im Ton benötigt werden, sollte für die nicht verwendeten Frequenzen der Wert 0 verwendet werden. Ein Ton, bei dem alle drei Frequenzen auf Null festgelegt sind, wird als Stille interpretiert und kann für die Stilleerkennung verwendet werden.

dwMediaControl

Mediensteuerungsaktion. Dieser Member verwendet eine der LINEMEDIACONTROL_ Konstanten.

Hinweise

Diese Struktur kann nicht erweitert werden.

Die LINEMEDIACONTROLTONE-Struktur definiert einen Tupelton <, eine Mediensteuerungsaktion>. Ein Array dieser Tupel wird an die lineSetMediaControl-Funktion übergeben, um Mediensteuerungsaktionen festzulegen, die durch Medientypänderungen für einen bestimmten Aufruf ausgelöst werden. Wenn eine Änderung an einem aufgelisteten Medientyp erkannt wird, wird die entsprechende Aktion für den Mediendatenstrom aufgerufen.

Ein Ton, bei dem alle Frequenzen auf null festgelegt sind, entspricht der Stille. Eine Anwendung kann somit den Informationsstrom des Anrufs auf Stille überwachen.

Anforderungen

Anforderung	Wert
Header	tapi.h

Weitere Informationen

TSPI_lineSetMediaControl

lineSetMediaControl