SetCommMask 함수(winbase.h)
통신 디바이스에 대해 모니터링할 이벤트 집합을 지정합니다.
구문
BOOL SetCommMask(
[in] HANDLE hFile,
[in] DWORD dwEvtMask
);
매개 변수
[in] hFile
통신 디바이스에 대한 핸들입니다. CreateFile 함수는 이 핸들을 반환합니다.
[in] dwEvtMask
사용할 이벤트입니다. 값이 0이면 모든 이벤트가 비활성화됩니다. 이 매개 변수는 다음 값 중 하나 이상일 수 있습니다.
| 값 | 의미 |
|---|---|
|
입력에서 중단이 발견되었습니다. |
|
CTS(전송 취소) 신호가 상태를 변경했습니다. |
|
DSR(데이터 세트 준비) 신호가 상태가 변경되었습니다. |
|
줄 상태 오류가 발생했습니다. 줄 상태 오류는 CE_FRAME, CE_OVERRUN 및 CE_RXPARITY. |
|
링 표시기가 감지되었습니다. |
|
RLSD(receive-line-signal-detect) 신호가 변경된 상태입니다. |
|
문자를 받아서 입력 버퍼에 배치했습니다. |
|
이벤트 문자가 수신되어 입력 버퍼에 배치되었습니다. 이벤트 문자는 SetCommState 함수를 사용하여 직렬 포트에 적용되는 디바이스의 DCB 구조에 지정됩니다. |
|
출력 버퍼의 마지막 문자가 전송되었습니다. |
반환 값
함수가 성공하면 반환 값이 0이 아닙니다.
함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.
설명
SetCommMask 함수는 특정 통신 리소스에 대해 모니터링할 수 있는 이벤트 집합을 지정합니다. 통신 리소스에 대한 핸들은 이벤트 중 하나가 발생할 때까지 대기하는 WaitCommEvent 함수에 대한 호출에서 지정할 수 있습니다. 통신 리소스의 현재 이벤트 마스크를 얻으려면 GetCommMask 함수를 사용합니다.
예제
예제는 통신 이벤트 모니터링을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | winbase.h(Windows.h 포함) |
| 라이브러리 | Kernel32.lib |
| DLL | Kernel32.dll |