PHONE_STATE pesan

TAPI mengirimkan pesan PHONE_STATE ke aplikasi setiap kali status perangkat telepon berubah.

            

Parameter

hPhone

Handel ke perangkat telepon.

dwCallbackInstance

Instans panggilan balik aplikasi yang disediakan saat membuka perangkat telepon.

dwParam1

Status telepon yang telah berubah. Parameter ini menggunakan salah satu konstanta PHONESTATE_.

dwParam2

Informasi tergantung status telepon yang merinci perubahan status. Parameter ini tidak digunakan jika beberapa bendera diatur dalam dwParam1, karena beberapa item status telah berubah. Aplikasi harus memanggil phoneGetStatus untuk mendapatkan sekumpulan informasi lengkap.

Jika dwParam1 PHONESTATE_OWNER, dwParam2 berisi jumlah pemilik baru.

Jika dwParam1 PHONESTATE_MONITORS, dwParam2 berisi jumlah monitor baru.

Jika dwParam1 PHONESTATE_LAMP, dwParam2 berisi pengidentifikasi tombol/lampu lampu yang telah berubah.

Jika dwParam1 PHONESTATE_RINGMODE, dwParam2 berisi mode cincin baru.

Jika dwParam1 PHONESTATE_HANDSET, SPEAKER, atau HEADSET, dwParam2 berisi mode hookswitch baru dari perangkat hookswitch tersebut. Parameter ini menggunakan salah satu konstanta PHONEHOOKSWITCHMODE_.

dwParam3

Tidak digunakan.

Mengembalikan nilai

Tidak ada nilai yang ditampilkan.

Keterangan

Mengirim pesan PHONE_STATE ke aplikasi dapat dikontrol dan dikueri menggunakan phoneSetStatusMessages dan phoneGetStatusMessages. Secara default, pesan ini dinonaktifkan untuk semua perubahan status kecuali untuk PHONESTATE_REINIT, yang tidak dapat dinonaktifkan. Pesan ini dikirim ke semua aplikasi yang memiliki handel ke telepon, termasuk yang disebut phoneOpen dengan parameter dwPrivileges diatur ke PHONEPRIVILEGE_OWNER atau PHONEPRIVILEGE_MONITOR.

Pesan PHONE_STATE dengan indikasi Pemilik dan/atau Monitor dikirim ke aplikasi yang sudah memiliki handel untuk telepon. Ini bisa menjadi hasil dari aplikasi lain yang mengubah kepemilikan atau pemantauan perangkat telepon dengan phoneOpen, phoneClose , atau phoneShutdown.

Persyaratan

Persyaratan Nilai
Versi TAPI
Membutuhkan TAPI 2.0 atau yang lebih baru
Header
Tapi.h

Lihat juga

PHONE_CLOSE

PHONECAPS

phoneClose

phoneGetDevCaps

phoneGetStatus

phoneGetStatusMessages

phoneInitialize

phoneInitializeEx

phoneBuka

phoneSetStatusMessages

phoneShutdown