Struktur LINEMEDIACONTROLTONE (tapi.h)
Struktur LINEMEDIACONTROLTONE menjelaskan tindakan media yang akan dijalankan ketika nada telah terdeteksi. Ini digunakan sebagai entri dalam array. Fungsi lineSetMediaControl dan TSPI_lineSetMediaControl menggunakan struktur ini.
Sintaks
typedef struct linemediacontroltone_tag {
DWORD dwAppSpecific;
DWORD dwDuration;
DWORD dwFrequency1;
DWORD dwFrequency2;
DWORD dwFrequency3;
DWORD dwMediaControl;
} LINEMEDIACONTROLTONE, *LPLINEMEDIACONTROLTONE;
Anggota
dwAppSpecific
Digunakan oleh aplikasi untuk menandai nada. Ketika nada ini terdeteksi, nilai anggota dwAppSpecific diteruskan kembali ke aplikasi.
dwDuration
Durasi waktu di mana nada harus ada sebelum deteksi dibuat, dalam milidetik.
dwFrequency1
Frekuensi pertama nada, dalam hertz.
dwFrequency2
Frekuensi kedua nada, dalam hertz.
dwFrequency3
Frekuensi ketiga nada, dalam hertz. Jika kurang dari tiga frekuensi diperlukan dalam nada , nilai 0 harus digunakan untuk frekuensi yang tidak digunakan. Nada dengan ketiga frekuensi yang diatur ke nol ditafsirkan sebagai keheningan dan dapat digunakan untuk deteksi keheningan.
dwMediaControl
Tindakan kontrol media. Anggota ini menggunakan salah satu konstanta LINEMEDIACONTROL_.
Keterangan
Struktur ini mungkin tidak diperpanjang.
Struktur LINEMEDIACONTROLTONE mendefinisikan nada tuple <, tindakan> kontrol media. Array tuple ini diteruskan ke fungsi lineSetMediaControl untuk mengatur tindakan kontrol media yang dipicu oleh perubahan jenis media untuk panggilan tertentu. Ketika perubahan pada jenis media yang tercantum terdeteksi, tindakan yang sesuai pada aliran media dipanggil.
Nada dengan semua frekuensi diatur ke nol sesuai dengan keheningan. Dengan demikian, aplikasi dapat memantau aliran informasi panggilan untuk keheningan.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Header | tapi.h |