fungsi phoneSetRing (tapi.h)

Fungsi phoneSetRing menyanyikan perangkat telepon terbuka yang ditentukan menggunakan mode dering dan volume yang ditentukan.

Sintaks

LONG phoneSetRing(
  HPHONE hPhone,
  DWORD  dwRingMode,
  DWORD  dwVolume
);

Parameter

hPhone

Tangani ke perangkat telepon terbuka. Aplikasi harus menjadi pemilik perangkat telepon.

dwRingMode

Pola dering untuk menyanyikan telepon. Parameter ini harus berada dalam rentang nol hingga nilai anggota dwNumRingModes dalam struktur PHONECAPS . Jika dwNumRingModes adalah nol, mode dering telepon tidak dapat dikontrol; jika dwNumRingModes adalah 1, nilai 0 untuk dwRingMode menunjukkan bahwa ponsel tidak boleh dibunyikan (diam), dan nilai lain dari 1 hingga dwNumRingModes adalah mode cincin yang valid untuk perangkat telepon.

dwVolume

Tingkat volume yang teleponnya berdering. Ini adalah angka dalam rentang 0x00000000 (keheningan) hingga 0x0000FFFF (volume maksimum). Granularitas aktual dan kuantisasi pengaturan volume dalam rentang ini khusus untuk penyedia layanan. Nilai untuk dwVolume yang berada di luar rentang diatur ke nilai terdekat dalam rentang.

Nilai kembali

Mengembalikan pengidentifikasi permintaan positif jika fungsi selesai secara asinkron atau nomor kesalahan negatif jika terjadi kesalahan. Parameter dwParam2 dari pesan PHONE_REPLY yang sesuai adalah nol jika fungsi berhasil atau merupakan nomor kesalahan negatif jika terjadi kesalahan. Nilai yang mungkin dikembalikan adalah:

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_NOTOWNER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALRINGMODE, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONUNAVAIL.

Keterangan

Penyedia layanan mendefinisikan pola dering aktual yang dapat didengar yang sesuai dengan masing-masing mode dering ponsel.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	tapi.h
Pustaka	Tapi32.lib
DLL	Tapi32.dll

Lihat juga

PHONECAPS

PHONE_REPLY

Fungsi Layanan Telepon Tambahan

Gambaran Umum Referensi TAPI 2.2