다음을 통해 공유

PurgeComm 함수(winbase.h)

  • 아티클

지정된 통신 리소스의 출력 또는 입력 버퍼에서 모든 문자를 삭제합니다. 리소스에 대한 보류 중인 읽기 또는 쓰기 작업을 종료할 수도 있습니다.

구문

BOOL PurgeComm(
  [in] HANDLE hFile,
  [in] DWORD  dwFlags
);

매개 변수

[in] hFile

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

[in] dwFlags

이 매개 변수는 다음 값 중 하나 이상일 수 있습니다.

값 의미
PURGE_RXABORT
0x0002
 읽기 작업이 완료되지 않은 경우에도 미해결 겹치는 읽기 작업을 모두 종료하고 즉시 반환합니다.
PURGE_RXCLEAR
0x0008
 입력 버퍼를 지웁니다(디바이스 드라이버에 있는 경우).
PURGE_TXABORT
0x0001
 미해결 겹치는 쓰기 작업을 모두 종료하고 쓰기 작업이 완료되지 않은 경우에도 즉시 반환됩니다.
PURGE_TXCLEAR
0x0004
 출력 버퍼를 지웁니다(디바이스 드라이버에 출력 버퍼가 있는 경우).

반환 값

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

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

설명

스레드가 PurgeComm 을 사용하여 출력 버퍼를 플러시하는 경우 삭제된 문자는 전송되지 않습니다. 콘텐츠가 전송되도록 하면서 출력 버퍼를 비우려면 FlushFileBuffers 함수(동기 작업)를 호출합니다. 그러나 FlushFileBuffers 는 흐름 제어가 적용되지만 시간 초과를 작성할 수 없으며 보류 중인 모든 쓰기 작업이 전송될 때까지 반환되지 않습니다.

요구 사항

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

참고 항목

Communications 함수

통신 리소스

CreateFile