SetCommMask 함수(winbase.h)

아티클
08/27/2023

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

구문

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_OVERRUN 및 CE_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