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 |