Fungsi SetCommMask (winbase.h)
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 |
|---|---|
|
Jeda terdeteksi pada input. |
|
Status perubahan sinyal CTS (clear-to-send). |
|
Status perubahan sinyal DSR (siap-set data). |
|
Terjadi kesalahan status baris. Kesalahan status baris CE_FRAME, CE_OVERRUN, dan CE_RXPARITY. |
|
Indikator cincin terdeteksi. |
|
Status perubahan sinyal RLSD (receive-line-signal-detect). |
|
Karakter diterima dan ditempatkan di buffer input. |
|
Karakter peristiwa diterima dan ditempatkan di buffer input. Karakter peristiwa ditentukan dalam struktur DCB perangkat, yang diterapkan ke port serial dengan menggunakan fungsi SetCommState . |
|
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 |