API / MFC/Serial Communications

ClearCommError Function

행복하면 2010. 4. 1. 19:17

통신 에러에 대한 정보를 받거나 통신 장치의 현재 상태를 보고 
이 함수는 통신 에러가 발생하거나 추가 입출력 작업을 사용할 수 있게 장치의 오류 플래그를 지울때 호출 됨

BOOL ClearCommError(
HANDLE hFile, 
LPDWORD lpErrors, 
LPCOMSTAT lpStat
);

hFile
통신 장치의 핸들, CreateFile 함수가 리턴한 핸들

lpErrors
A pointer to a variable that receives a mask indicating the type of error.
오류 유형을 나타내는 마스크의 값을 받을 포인터
This parameter can be one or more of the following values.
이 매개변수는 다음 값이 하나이상을 가질 수 있음
          ┃
          ┣> CE_BREAK
          ┃      ┗ 하드웨어 중단 조건을 감지
          ┃
          ┣> CE_FRAME
          ┃      ┗ 하드웨어 프레임 에러 감지
          ┃
          ┣> CE_OVERRUN
          ┃      ┗ 문자 버퍼 오버런 발생됨, 다음 문자 손실
          ┃
          ┣> CE_RXOVER
          ┃      ┣ 입력 버퍼 오버플로우 발생됨.
          ┃      ┗  입력 버퍼의 공간이 없던지, EOF 문자를 받은 후에 문자가 있을 시 발생
          ┃
          ┗> CE_RXPARITY
                  ┗ 하드웨어 패리티 에러 감지

lpStat
반환되는 장치 상태 정보를 COMSTAT 구조체의 포인터
NULL => 반환되는 상태 정보를 받지 않음



참조 :
http://msdn.microsoft.com/en-us/library/aa363180(VS.85).aspx