GetCommMask 함수(winbase.h)

아티클
03/03/2024

지정된 통신 디바이스에 대한 이벤트 마스크 값을 검색합니다.

구문

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

매개 변수

[in] hFile

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

[out] lpEvtMask

현재 사용하도록 설정된 이벤트의 마스크를 수신하는 변수에 대한 포인터입니다. 이 매개 변수는 다음 값 중 하나 이상일 수 있습니다.

값	의미
EV_BREAK 0x0040	입력에서 중단이 발견되었습니다.
EV_CTS 0x0008	CTS(전송 취소) 신호가 상태가 변경되었습니다.
EV_DSR 0x0010	DSR(데이터 세트 준비) 신호가 상태가 변경되었습니다.
EV_ERR 0x0080	줄 상태 오류가 발생했습니다. 줄 상태 오류는 CE_FRAME, CE_OVERRUN 및 CE_RXPARITY.
EV_EVENT1 0x0800	첫 번째 공급자별 형식의 이벤트가 발생했습니다.
EV_EVENT2 0x1000	두 번째 공급자별 형식의 이벤트가 발생했습니다.
EV_PERR 0x0200	프린터 오류가 발생했습니다.
EV_RING 0x0100	링 표시기가 감지되었습니다.
EV_RLSD 0x0020	RLSD(receive-line-signal-detect) 신호가 변경된 상태입니다.
EV_RX80FULL 0x0400	수신 버퍼가 80% 가득 찼습니다.
EV_RXCHAR 0x0001	문자를 받아서 입력 버퍼에 배치했습니다.
EV_RXFLAG 0x0002	이벤트 문자가 수신되어 입력 버퍼에 배치되었습니다. 이벤트 문자는 SetCommState 함수를 사용하여 직렬 포트에 적용되는 디바이스의 DCB 구조에 지정됩니다.
EV_TXEMPTY 0x0004	출력 버퍼의 마지막 문자가 전송되었습니다.

반환 값

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

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

설명

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

요구 사항

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