Fungsi GetCommMask (winbase.h)

Artikel
03/09/2024

Mengambil nilai masker peristiwa untuk perangkat komunikasi tertentu.

Sintaks

BOOL GetCommMask(
  [in]  HANDLE  hFile,
  [out] LPDWORD lpEvtMask
);

Parameter

[in] hFile

Handel ke perangkat komunikasi. Fungsi CreateFile mengembalikan handel ini.

[out] lpEvtMask

Penunjuk ke variabel yang menerima masker peristiwa yang saat ini diaktifkan. 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 (data-set-ready).
EV_ERR 0x0080	Terjadi kesalahan status baris. Kesalahan status baris CE_FRAME, CE_OVERRUN, dan CE_RXPARITY.
EV_EVENT1 0x0800	Terjadi peristiwa jenis khusus penyedia pertama.
EV_EVENT2 0x1000	Terjadi peristiwa jenis khusus penyedia kedua.
EV_PERR 0x0200	Terjadi kesalahan printer.
EV_RING 0x0100	Indikator cincin terdeteksi.
EV_RLSD 0x0020	Status sinyal RLSD (receive-line-signal-detect) berubah.
EV_RX80FULL 0x0400	Buffer penerima 80 persen penuh.
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 GetCommMask menggunakan variabel mask untuk menunjukkan 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 mengubah masker peristiwa sumber daya komunikasi, gunakan fungsi SetCommMask .

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