Share via


SetCommState 함수(winbase.h)

디바이스 제어 블록( DCB 구조)의 사양에 따라 통신 디바이스를 구성합니다. 함수는 모든 하드웨어 및 컨트롤 설정을 다시 초기화하지만 출력이나 입력 큐는 비어 있지 않습니다.

구문

BOOL SetCommState(
  [in] HANDLE hFile,
  [in] LPDCB  lpDCB
);

매개 변수

[in] hFile

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

[in] lpDCB

지정된 통신 디바이스에 대한 구성 정보를 포함하는 DCB 구조체에 대한 포인터입니다.

반환 값

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

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

설명

SetCommState 함수는 DCB 구조를 사용하여 원하는 구성을 지정합니다. GetCommState 함수는 현재 구성을 반환합니다.

DCB 구조체의 일부 멤버만 설정하려면 GetCommState 호출로 채워진 DCB 구조를 수정해야 합니다. 이렇게 하면 DCB 구조체의 다른 멤버에 적절한 값이 있습니다.

DCB 구조체의 XonChar 멤버가 XoffChar 멤버와 같으면 SetCommState 함수 가 실패합니다.

SetCommState를 사용하여 8250을 구성하는 경우 DCB 구조체의 ByteSizeStopBits 멤버 값에 다음 제한이 적용됩니다.

데이터 비트 수는 5~8비트여야 합니다.

예제

예제는 통신 리소스 구성을 참조하세요.

요구 사항

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

참고 항목

BuildCommDCB

Communications 함수

통신 리소스

CreateFile

DCB

GetCommState