fungsi phoneSetHookSwitch (tapi.h)

  • Artikel

Fungsi phoneSetHookSwitch mengatur status kait dari perangkat hookswitch ponsel terbuka yang ditentukan ke mode yang ditentukan. Hanya status hookswitch perangkat hookswitch yang tercantum yang terpengaruh.

Sintaks

LONG phoneSetHookSwitch(
  HPHONE hPhone,
  DWORD  dwHookSwitchDevs,
  DWORD  dwHookSwitchMode
);

Parameter

hPhone

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

dwHookSwitchDevs

Perangkat yang mode pengaitnya akan diatur. Parameter ini menggunakan satu dan hanya satu dari konstanta PHONEHOOKSWITCHDEV_.

PHONEHOOKSWITCHDEV_HANDSET

Handset telepon.

PHONEHOOKSWITCHDEV_SPEAKER

Speakerphone atau adjunct telepon.

PHONEHOOKSWITCHDEV_HEADSET

Headset telepon.

dwHookSwitchMode

Mode Hookswitch untuk diatur. Parameter ini menggunakan satu dan hanya satu dari konstanta PHONEHOOKSWITCHMODE_.

PHONEHOOKSWITCHMODE_ONHOOK

Mikrofon dan speaker perangkat keduanya onhook.

PHONEHOOKSWITCHMODE_MIC

Mikrofon perangkat aktif, speaker bisu.

PHONEHOOKSWITCHMODE_SPEAKER

Speaker perangkat aktif, mikrofon bisu.

PHONEHOOKSWITCHMODE_MICSPEAKER

Mikrofon dan speaker perangkat keduanya aktif.

Mengembalikan nilai

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_OPERATIONUNAVAIL, PHONEERR_NOTOWNER, PHONEERR_NOMEM, PHONEERR_INVALHOOKSWITCHDEV, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALHOOKSWITCHMODE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPHONESTATE, PHONEERR_UNINITIALIZED.

Keterangan

Mode hookswitch sama untuk semua perangkat yang ditentukan. Jika pengaturan yang berbeda diinginkan, fungsi ini dapat dipanggil beberapa kali dengan serangkaian parameter yang berbeda. Pesan PHONE_STATE dikirim ke aplikasi setelah status hookswitch berubah.

Persyaratan

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

Lihat juga

PHONE_REPLY

PHONE_STATE

Fungsi Layanan Telepon Tambahan

Gambaran Umum Referensi TAPI 2.2