Fungsi SetCommMask (winbase.h)

Artikel
03/13/2024

Menentukan serangkaian peristiwa yang akan dipantau untuk perangkat komunikasi.

Sintaks

BOOL SetCommMask(
  [in] HANDLE hFile,
  [in] DWORD  dwEvtMask
);

Parameter

[in] hFile

Handel ke perangkat komunikasi. Fungsi CreateFile mengembalikan handel ini.

[in] dwEvtMask

Peristiwa yang akan diaktifkan. Nilai nol menonaktifkan semua peristiwa. Parameter ini bisa menjadi satu atau beberapa nilai berikut.

Nilai	Makna
EV_BREAK 0x0040	Jeda terdeteksi pada input.
EV_CTS 0x0008	Status perubahan sinyal CTS (clear-to-send).
EV_DSR 0x0010	Status perubahan sinyal DSR (siap-set data).
EV_ERR 0x0080	Terjadi kesalahan status baris. Kesalahan status baris CE_FRAME, CE_OVERRUN, dan CE_RXPARITY.
EV_RING 0x0100	Indikator cincin terdeteksi.
EV_RLSD 0x0020	Status perubahan sinyal RLSD (receive-line-signal-detect).
EV_RXCHAR 0x0001	Karakter diterima dan ditempatkan di buffer input.
EV_RXFLAG 0x0002	Karakter peristiwa diterima dan ditempatkan di buffer input. Karakter peristiwa ditentukan dalam struktur DCB perangkat, yang diterapkan ke port serial dengan menggunakan fungsi SetCommState .
EV_TXEMPTY 0x0004	Karakter terakhir dalam buffer output dikirim.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Fungsi SetCommMask menentukan serangkaian peristiwa yang dapat dipantau untuk sumber daya komunikasi tertentu. Handel ke sumber daya komunikasi dapat ditentukan dalam panggilan ke fungsi WaitCommEvent , yang menunggu salah satu peristiwa terjadi. Untuk mendapatkan masker peristiwa saat ini dari sumber daya komunikasi, gunakan fungsi GetCommMask .

Contoh

Misalnya, lihat Memantau Peristiwa Komunikasi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	winbase.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll