TSPI_lineSetDefaultMediaDetection (tspi.h)

Prosedur TSPI_lineSetDefaultMediaDetection memberi tahu penyedia layanan sekumpulan jenis media baru untuk mendeteksi baris yang ditunjukkan (mengganti set sebelumnya). Ini juga menetapkan set awal jenis media yang harus dipantau pada panggilan berikutnya (masuk atau keluar) pada baris ini.

Sintaks

LONG TSPIAPI TSPI_lineSetDefaultMediaDetection(
  HDRVLINE hdLine,
  DWORD    dwMediaModes
);

Parameter

hdLine

Handel ke garis untuk mengatur pemantauan media.

dwMediaModes

Jenis media yang menarik bagi TAPI. Parameter ini menggunakan salah satu konstanta LINEMEDIAMODE_:

Nilai kembali

Mengembalikan nol jika fungsi berhasil, atau angka kesalahan jika terjadi kesalahan. Kemungkinan nilai yang dikembalikan adalah sebagai berikut:

LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALMEDIAMODE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_NODRIVER, LINEERR_OPERATIONUNAVAIL.

Keterangan

TAPI biasanya memanggil fungsi ini untuk memperbarui kumpulan jenis media yang terdeteksi untuk garis ke penyatuan semua mode yang dipilih oleh semua baris yang luar biasaBuka setiap kali baris Dibuka atau Ditutup di tingkat TAPI. Upaya panggilan lineOpen ditolak jika deteksi media ditolak. Satu panggilan ke prosedur ini biasanya merupakan hasil dari panggilan lineOpen yang tidak menentukan pengidentifikasi perangkat LINEMAPPER. Pengidentifikasi perangkat LINEMAPPER tidak pernah digunakan pada tingkat TSPI.

TAPI harus menghitung penyatuan jenis media yang diinginkan oleh semua klien dan meneruskan hasilnya ke fungsi ini. Penyedia layanan menggunakan set yang diteruskan ke fungsi ini oleh TAPI. TAPI memastikan bahwa parameter dwMediaModes memiliki setidaknya satu bit yang ditetapkan dan tidak ada bit yang dipesan yang diatur. Penyedia layanan harus melakukan pemeriksaan validitas lebih lanjut pada jenis media, seperti memeriksa apakah ada jenis media yang memang didukung oleh penyedia layanan. Persatuan semua jenis media dapat menjadi nilai 0 jika aplikasi yang membuka baris adalah semua monitor atau tidak tertarik untuk menangani panggilan masuk.

Tidak ada fungsi yang sesuai langsung di tingkat TAPI. Prosedur ini sesuai dengan "jenis media permintaan" yang tersirat untuk baris tertentu oleh prosedur lineOpen ketika dipanggil dengan pengidentifikasi perangkat tertentu (selain LINEMAPPER).

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	tspi.h

Lihat juga

LINECALLPARAMS

Konstanta LINEMEDIAMODE_

TSPI_lineClose