LINEMONITORTONE-Struktur (tapi.h)

  • Artikel

Die LINEMONITORTONE-Struktur beschreibt einen zu überwachenden Ton. Dies wird als Eintrag in einem Array verwendet. Die Funktionen lineMonitorTones und TSPI_lineMonitorTones verwenden diese Struktur.

Syntax

typedef struct linemonitortone_tag {
  DWORD dwAppSpecific;
  DWORD dwDuration;
  DWORD dwFrequency1;
  DWORD dwFrequency2;
  DWORD dwFrequency3;
} LINEMONITORTONE, *LPLINEMONITORTONE;

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.

Hinweise

Diese Struktur kann nicht erweitert werden.

Die LINEMONITORTONE-Struktur definiert einen Ton zum Zweck der Erkennung. Ein Array von Tönen wird an die lineMonitorTones-Funktion übergeben, die diese Töne überwacht und eine LINE_MONITORTONE Nachricht an die Anwendung sendet, wenn eine Erkennung erfolgt.

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

Anforderungen

Anforderung Wert
Header tapi.h

Weitere Informationen

LINE_MONITORTONE

TSPI_lineMonitorTones

lineMonitorTones