Struttura LINEMEDIACONTROLTONE (tapi.h)

La struttura LINEMEDIACONTROLTONE descrive un'azione multimediale da eseguire quando è stato rilevato un tono. Viene usato come voce in una matrice. Le funzioni lineSetMediaControl e TSPI_lineSetMediaControl usano questa struttura.

Sintassi

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

Members

dwAppSpecific

Usato dall'applicazione per contrassegnare il tono. Quando viene rilevato questo tono, il valore del membro dwAppSpecific viene passato all'applicazione.

dwDuration

Durata del tempo durante il quale il tono deve essere presente prima che venga effettuato un rilevamento, in millisecondi.

dwFrequency1

Prima frequenza del tono, in hertz.

dwFrequency2

Seconda frequenza del tono, in hertz.

dwFrequency3

Terza frequenza del tono, in hertz. Se sono necessarie meno di tre frequenze nel tono, deve essere usato un valore pari a 0 per le frequenze inutilizzate. Un tono con tutte e tre le frequenze impostate su zero viene interpretato come silenzio e può essere usato per il rilevamento del silenzio.

dwMediaControl

Azione di controllo multimediale. Questo membro usa una delle costanti LINEMEDIACONTROL_.

Commenti

Questa struttura potrebbe non essere estesa.

La struttura LINEMEDIACONTROLTONE definisce un'azione> di tupla<, controllo multimediale. Una matrice di queste tuple viene passata alla funzione lineSetMediaControl per impostare le azioni di controllo multimediale attivate da modifiche al tipo di supporto per una determinata chiamata. Quando viene rilevata una modifica a un tipo di supporto elencato, viene richiamata l'azione corrispondente nel flusso multimediale.

Un tono con tutte le frequenze impostate su zero corrisponde al silenzio. Un'applicazione può quindi monitorare il flusso informativo della chiamata per il silenzio.

Requisiti

Requisito Valore
Intestazione tapi.h

Vedi anche

TSPI_lineSetMediaControl

lineSetMediaControl