COMMPROP 구조체(winbase.h)

아티클
08/27/2023

통신 드라이버에 대한 정보를 포함합니다.

구문

typedef struct _COMMPROP {
  WORD  wPacketLength;
  WORD  wPacketVersion;
  DWORD dwServiceMask;
  DWORD dwReserved1;
  DWORD dwMaxTxQueue;
  DWORD dwMaxRxQueue;
  DWORD dwMaxBaud;
  DWORD dwProvSubType;
  DWORD dwProvCapabilities;
  DWORD dwSettableParams;
  DWORD dwSettableBaud;
  WORD  wSettableData;
  WORD  wSettableStopParity;
  DWORD dwCurrentTxQueue;
  DWORD dwCurrentRxQueue;
  DWORD dwProvSpec1;
  DWORD dwProvSpec2;
  WCHAR wcProvChar[1];
} COMMPROP, *LPCOMMPROP;

멤버

wPacketLength

요청된 데이터의 양에 관계없이 전체 데이터 패킷의 크기(바이트)입니다.

wPacketVersion

구조체의 버전입니다.

dwServiceMask

이 공급자가 구현하는 서비스를 나타내는 비트 마스크입니다. SP_SERIALCOMM 값은 항상 모뎀 공급자를 포함한 통신 공급자에 대해 지정됩니다.

dwReserved1

예약되어 있으므로 사용하지 마세요.

dwMaxTxQueue

드라이버 내부 출력 버퍼의 최대 크기(바이트)입니다. 값이 0이면 직렬 공급자가 최대값을 부과하지 않음을 나타냅니다.

dwMaxRxQueue

드라이버 내부 입력 버퍼의 최대 크기(바이트)입니다. 값이 0이면 직렬 공급자가 최대값을 부과하지 않음을 나타냅니다.

dwMaxBaud

허용되는 최대 전송 속도(초당 비트 수)(bps)입니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

값	의미
BAUD_075 0x00000001	75bps
BAUD_110 0x00000002	110bps
BAUD_134_5 0x00000004	134.5bps
BAUD_150 0x00000008	150bps
BAUD_300 0x00000010	300bps
BAUD_600 0x00000020	600bps
BAUD_1200 0x00000040	1200 bps
BAUD_1800 0x00000080	1800bps
BAUD_2400 0x00000100	2400 bps
BAUD_4800 0x00000200	4800 bps
BAUD_7200 0x00000400	7200 bps
BAUD_9600 0x00000800	9600 bps
BAUD_14400 0x00001000	14400 bps
BAUD_19200 0x00002000	19200 bps
BAUD_38400 0x00004000	38400 bps
BAUD_56K 0x00008000	56K bps
BAUD_57600 0x00040000	57600 bps
BAUD_115200 0x00020000	115200 bps
BAUD_128K 0x00010000	128K bps
BAUD_USER 0x10000000	프로그래밍 가능한 전송 속도입니다.

dwProvSubType

통신 공급자 유형입니다.

값	의미
PST_FAX 0x00000021	FAX 디바이스
PST_LAT 0x00000101	LAT 프로토콜
PST_MODEM 0x00000006	모뎀 디바이스
PST_NETWORK_BRIDGE 0x00000100	지정되지 않은 네트워크 브리지
PST_PARALLELPORT 0x00000002	병렬 포트
PST_RS232 0x00000001	RS-232 직렬 포트
PST_RS422 0x00000003	RS-422 포트
PST_RS423 0x00000004	RS-423 포트
PST_RS449 0x00000005	RS-449 포트
PST_SCANNER 0x00000022	스캐너 디바이스
PST_TCPIP_TELNET 0x00000102	TCP/IP 텔넷 프로토콜
PST_UNSPECIFIED 0x00000000	Unspecified
PST_X25 0x00000103	X.25 표준

dwProvCapabilities

공급자가 제공하는 기능을 나타내는 비트 마스크입니다. 이 멤버는 다음 값의 조합일 수 있습니다.

값	의미
PCF_16BITMODE 0x0200	지원되는 특수 16비트 모드
PCF_DTRDSR 0x0001	DTR(데이터 터미널 준비)/DSR(데이터 세트 준비) 지원
PCF_INTTIMEOUTS 0x0080	지원되는 간격 시간 제한
PCF_PARITY_CHECK 0x0008	패리티 검사 지원
PCF_RLSD 0x0004	RLSD(receive-line-signal-detect) 지원
PCF_RTSCTS 0x0002	RTS(보내기 요청)/CTS(송신 취소) 지원됨
PCF_SETXCHAR 0x0020	Settable XON/XOFF 지원
PCF_SPECIALCHARS 0x0100	특수 문자 지원 제공
PCF_TOTALTIMEOUTS 0x0040	지원되는 총(경과된) 시간 제한
PCF_XONXOFF 0x0010	지원되는 XON/XOFF 흐름 제어

dwSettableParams

변경할 수 있는 통신 매개 변수를 나타내는 비트 마스크입니다. 이 멤버는 다음 값의 조합일 수 있습니다.

값	의미
SP_BAUD 0x0002	전송 속도
SP_DATABITS 0x0004	데이터 비트
SP_HANDSHAKING 0x0010	핸드셰이크(흐름 제어)
SP_PARITY 0x0001	Parity
SP_PARITY_CHECK 0x0020	패리티 검사
SP_RLSD 0x0040	RLSD(receive-line-signal-detect)
SP_STOPBITS 0x0008	정지 비트

dwSettableBaud

사용할 수 있는 전송 속도입니다. 값은 dwMaxBaud 멤버를 참조하세요.

wSettableData

설정할 수 있는 데이터 비트 수를 나타내는 비트 마스크입니다. 이 멤버는 다음 값의 조합일 수 있습니다.

값	의미
DATABITS_5 0x0001	데이터 비트 5개
DATABITS_6 0x0002	6개 데이터 비트
DATABITS_7 0x0004	7개 데이터 비트
DATABITS_8 0x0008	8 데이터 비트
DATABITS_16 0x0010	16개 데이터 비트
DATABITS_16X 0x0020	직렬 하드웨어 라인을 통한 특수 와이드 경로

wSettableStopParity

선택할 수 있는 중지 비트 및 패리티 설정을 나타내는 비트 마스크입니다. 이 멤버는 다음 값의 조합일 수 있습니다.

값	의미
STOPBITS_10 0x0001	1 정지 비트
STOPBITS_15 0x0002	1.5 중지 비트
STOPBITS_20 0x0004	중지 비트 2개
PARITY_NONE 0x0100	패리티 없음
PARITY_ODD 0x0200	홀수 패리티
PARITY_EVEN 0x0400	패리티 짝수
PARITY_MARK 0x0800	패리티 표시
PARITY_SPACE 0x1000	공간 패리티

dwCurrentTxQueue

드라이버의 내부 출력 버퍼 크기(바이트)입니다. 값이 0이면 값을 사용할 수 없음을 나타냅니다.

dwCurrentRxQueue

드라이버의 내부 입력 버퍼 크기(바이트)입니다. 값이 0이면 값을 사용할 수 없음을 나타냅니다.

dwProvSpec1

모든 공급자별 데이터입니다. 애플리케이션은 공급자가 요구하는 데이터 형식에 대한 자세한 정보가 없는 한 이 멤버를 무시해야 합니다.

GetCommProperties 함수를 호출하기 전에 이 멤버를 COMMPROP_INITIALIZED 설정하여 wPacketLength 멤버가 이미 유효함을 나타냅니다.

dwProvSpec2

모든 공급자별 데이터입니다. 애플리케이션은 공급자가 요구하는 데이터 형식에 대한 자세한 정보가 없는 한 이 멤버를 무시해야 합니다.

wcProvChar[1]

모든 공급자별 데이터입니다. 애플리케이션은 공급자가 요구하는 데이터 형식에 대한 자세한 정보가 없는 한 이 멤버를 무시해야 합니다.

설명

dwProvSpec1, dwProvSpec2 및 wcProvChar 멤버의 내용은 공급자 하위 형식(dwProvSubType 멤버로 지정됨)에 따라 달라집니다.

공급자 하위 형식이 PST_MODEM 경우 이러한 멤버는 다음과 같이 사용됩니다.

값	의미
dwProvSpec1	사용되지 않습니다.
dwProvSpec2	사용되지 않습니다.
wcProvChar	MODEMDEVCAPS 구조체를 포함합니다.

요구 사항


지원되는 최소 클라이언트	Windows XP
지원되는 최소 서버	Windows Server 2003
머리글	winbase.h(Windows.h 포함)

추가 정보

GetCommProperties

다음을 통해 공유

COMMPROP 구조체(winbase.h)

구문

멤버

설명

요구 사항

추가 정보

피드백

추가 리소스