다음을 통해 공유


SetCommMask 함수(winbase.h)

통신 디바이스에 대해 모니터링할 이벤트 집합을 지정합니다.

구문

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

매개 변수

[in] hFile

통신 디바이스에 대한 핸들입니다. CreateFile 함수는 이 핸들을 반환합니다.

[in] dwEvtMask

사용할 이벤트입니다. 값이 0이면 모든 이벤트가 비활성화됩니다. 이 매개 변수는 다음 값 중 하나 이상일 수 있습니다.

의미
EV_BREAK
0x0040
입력에서 중단이 발견되었습니다.
EV_CTS
0x0008
CTS(전송 취소) 신호가 상태를 변경했습니다.
EV_DSR
0x0010
DSR(데이터 세트 준비) 신호가 상태가 변경되었습니다.
EV_ERR
0x0080
줄 상태 오류가 발생했습니다. 줄 상태 오류는 CE_FRAME, CE_OVERRUNCE_RXPARITY.
EV_RING
0x0100
링 표시기가 감지되었습니다.
EV_RLSD
0x0020
RLSD(receive-line-signal-detect) 신호가 변경된 상태입니다.
EV_RXCHAR
0x0001
문자를 받아서 입력 버퍼에 배치했습니다.
EV_RXFLAG
0x0002
이벤트 문자가 수신되어 입력 버퍼에 배치되었습니다. 이벤트 문자는 SetCommState 함수를 사용하여 직렬 포트에 적용되는 디바이스의 DCB 구조에 지정됩니다.
EV_TXEMPTY
0x0004
출력 버퍼의 마지막 문자가 전송되었습니다.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

SetCommMask 함수는 특정 통신 리소스에 대해 모니터링할 수 있는 이벤트 집합을 지정합니다. 통신 리소스에 대한 핸들은 이벤트 중 하나가 발생할 때까지 대기하는 WaitCommEvent 함수에 대한 호출에서 지정할 수 있습니다. 통신 리소스의 현재 이벤트 마스크를 얻으려면 GetCommMask 함수를 사용합니다.

예제

예제는 통신 이벤트 모니터링을 참조하세요.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows XP [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 winbase.h(Windows.h 포함)
라이브러리 Kernel32.lib
DLL Kernel32.dll

참고 항목

Communications 함수

통신 리소스

CreateFile

DCB

GetCommMask

SetCommState

WaitCommEvent