Win32_SerialPortConfiguration 클래스

Win32_SerialPortConfigurationWMI 클래스는 Windows 기반 직렬 포트에서 데이터 전송에 대한 설정을 나타냅니다. 여기에는 연결 및 오류 검사를 설정하기 위한 구성이 포함됩니다.

다음 구문은 MOF(Managed Object Format) 코드를 단순화한 것으로 상속된 속성이 모두 포함되어 있습니다. 속성은 MOF 순서가 아닌 알파벳순으로 나열됩니다.

구문

[Dynamic, Provider("CIMWin32"), UUID("{8502C4EB-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_SerialPortConfiguration : CIM_Setting
{
  string  Caption;
  string  Description;
  string  SettingID;
  boolean AbortReadWriteOnError;
  uint32  BaudRate;
  boolean BinaryModeEnabled;
  uint32  BitsPerByte;
  boolean ContinueXMitOnXOff;
  boolean CTSOutflowControl;
  boolean DiscardNULLBytes;
  boolean DSROutflowControl;
  boolean DSRSensitivity;
  string  DTRFlowControlType;
  uint32  EOFCharacter;
  uint32  ErrorReplaceCharacter;
  boolean ErrorReplacementEnabled;
  uint32  EventCharacter;
  boolean IsBusy;
  string  Name;
  string  Parity;
  boolean ParityCheckEnabled;
  string  RTSFlowControlType;
  string  StopBits;
  uint32  XOffCharacter;
  uint32  XOffXMitThreshold;
  uint32  XOnCharacter;
  uint32  XOnXMitThreshold;
  uint32  XOnXOffInFlowControl;
  uint32  XOnXOffOutFlowControl;
};

멤버

Win32_SerialPortConfiguration 클래스에는 다음과 같은 유형의 멤버가 있습니다.

• 속성

속성

Win32_SerialPortConfiguration 클래스에는 이러한 속성이 있습니다.

AbortReadWriteOnError

데이터 형식: boolean

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 통신 구조| DCB|fAbortOnError")

TRUE이면 오류가 발생하면 읽기 및 쓰기 작업이 종료됩니다. TRUE이면 오류가 발생하면 드라이버가 오류 상태 모든 읽기 및 쓰기 작업을 종료합니다. 애플리케이션이 오류를 승인할 때까지 드라이버는 추가 통신 작업을 수락하지 않습니다.

BaudRate

데이터 형식: uint32

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 통신 구조| DCB| BaudRate")

통신 디바이스가 작동하는 전송 속도(초당 비트) 속도입니다.

예: 9600

BinaryModeEnabled

데이터 형식: boolean

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 통신 구조| DCB|fBinary")

TRUE이면 직렬 포트에 대해 이진 모드 데이터 전송이 사용하도록 설정됩니다. Windows를 실행하는 컴퓨터 시스템은 직렬 포트를 통한 이진 전송만 허용하므로 이 값은 항상 TRUE입니다.

BitsPerByte

데이터 형식: uint32

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 통신 구조| DCB| ByteSize")

Windows 직렬 포트에 대한 데이터의 각 바이트에 대해 전송 및 수신된 비트 수입니다. 숫자는 패리티 비트와 같은 제어 및 오류 수정 비트에 따라 달라질 수 있습니다.

예: 8

캡션

데이터 형식: string

액세스 형식: 읽기 전용

한정자: MaxLen(64)

현재 개체에 대한 간단한 텍스트 설명입니다.

이 속성은 CIM_Setting 상속됩니다.

ContinueXMitOnXOff

데이터 형식: boolean

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 통신 구조| DCB|fTXContinueOnXoff")

TRUE이면 입력 버퍼가 가득 찬 XOffXMitThreshold 바이트 내에 있고 드라이버가 XOffChararcter 값을 전송하여 바이트 수신을 중지하면 데이터 전송이 계속됩니다. FALSE이면 입력 버퍼가 비어 있는 XOnXMitThreshold 바이트 내에 있고 드라이버가 수신을 다시 시작하기 위해 XOnCharacter 값을 전송할 때까지 전송이 계속되지 않습니다.

CTSOutflowControl

데이터 형식: boolean

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 통신 구조| DCB|fOutxCtsFlow")

TRUE이면 데이터를 전송하기 전에 CTS(Clear to Send) 신호를 확인합니다. CTS는 직렬 연결의 두 디바이스가 모두 데이터를 전송할 준비가 되었음을 알려줍니다. CTS 신호가 제공될 때까지 데이터 전송이 일시 중단됩니다.

설명

데이터 형식: 문자열

액세스 형식: 읽기 전용

현재 개체에 대한 텍스트 설명입니다.

이 속성은 CIM_Setting 상속됩니다.

DiscardNULLBytes

데이터 형식: boolean

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 통신 구조| DCB|fNull")

TRUE이면 수신될 때 NULL 바이트(문자)가 삭제됩니다.

DSROutflowControl

데이터 형식: boolean

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 통신 구조| DCB|fOutxDsrFlow")

TRUE이면 DSR(데이터 세트 준비) 조건이 있는 경우 데이터 유출 제어가 활성화됩니다. DSR은 직렬 연결의 디바이스에서 연결을 설정했음을 신호로 표시합니다. DSR 신호가 제공될 때까지 DSR 데이터 전송이 일시 중단됩니다.

DSRSensitivity

데이터 형식: boolean

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 통신 구조| DCB|fDsrSensitivity")

TRUE이면 통신 드라이버가 DSR 신호의 상태에 민감합니다. DSR 모뎀 입력 줄이 높지 않으면 드라이버는 수신된 바이트를 무시합니다.

DTRFlowControlType

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 통신 구조| DCB|fDtrControl")

연결이 설정된 후 DTR(데이터 터미널 준비) 흐름 제어를 사용합니다.

사용 ("사용")

사용 안 함 ("사용 안 함")

핸드셰이크 ("핸드셰이크")

EOFCharacter

데이터 형식: uint32

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 통신 구조| DCB| EofChar")

데이터 끝을 알리는 데 사용되는 문자의 값입니다.

예: ^Z

ErrorReplaceCharacter

데이터 형식: uint32

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 통신 구조| DCB| ErrorChar")

수신된 바이트를 패리티 오류로 바꾸는 데 사용되는 문자의 값입니다.

예: ^C

ErrorReplacementEnabled

데이터 형식: boolean

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 통신 구조| DCB|fErrorChar")

TRUE이면 패리티 오류로 수신된 바이트가 ErrorReplaceCharacter 값으로 바뀝니다. 패리티 오류가 있는 문자는 이 속성이 TRUE 이고 패리티가 사용하도록 설정된 경우에만 대체됩니다.

EventCharacter

데이터 형식: uint32

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 통신 구조| DCB| EvtChar")

파일의 끝과 같은 이벤트를 신호하는 데 사용되는 컨트롤 문자의 값입니다.

예: ^e

Isbusy

데이터 형식: boolean

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 파일 함수| CreateFile")

TRUE이면 직렬 포트가 사용 중입니다.

이름

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: key, MaxLen (256), MappingStrings ("Win32Registry| Hardware\\DeviceMap\\SerialComm")

Windows 직렬 포트의 이름입니다.

예: "COM1"

Parity

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 통신 구조| DCB| 패리티")

사용할 패리티 검사 방법입니다. 패리티는 모든 데이터 단위에 추가 패리티 비트가 포함된 오류 검사 기술로 사용됩니다. 그런 다음 수신기는 설정된 비트를 계산하여 데이터의 유효성을 확인할 수 있습니다.

None ("None")

패리티 검사는 사용되지 않습니다.

홀수 ("홀수")

비트 집합의 비트 합계가 홀수가 되도록 패리티 비트를 설정합니다.

Even ("Even")

비트 집합의 비트 합계가 짝수가 되도록 패리티 비트를 설정합니다.

Mark ("Mark")

패리티 비트를 1로 설정된 상태로 유지합니다.

Space ("Space")

패리티 비트는 0(0)으로 설정됩니다.

ParityCheckEnabled

데이터 형식: boolean

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 통신 구조| DCB|fParity")

TRUE이면 패리티 검사를 사용하도록 설정합니다.

RTSFlowControlType

데이터 형식: 문자열

액세스 형식: 읽기 전용

전송 요청(RTS) 흐름 제어입니다. RTS는 데이터를 전송에 사용할 수 있음을 알리는 데 사용됩니다.

사용 ("사용")

RTS는 데이터 전송 세션에 남아 있습니다.

사용 안 함 ("사용 안 함")

RTS는 첫 번째 RTS 신호가 수신된 후 무시됩니다.

핸드셰이크 ("핸드셰이크")

전송 버퍼가 3분의 1 이상 가득 차면 RTS가 꺼지고 버퍼가 절반 미만이 가득 차면 RTS가 켜집니다.

토글 ("토글")

전송을 위해 버퍼링된 데이터가 있는 경우 RTS가 켜집니다.

SettingID

데이터 형식: string

액세스 형식: 읽기 전용

한정자: MaxLen(256)

현재 개체가 알려진 식별자입니다.

이 속성은 CIM_Setting 상속됩니다.

StopBits

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 통신 구조| DCB| StopBits")

사용할 중지 비트 수입니다. 정지 비트 비동기 직렬 연결에서 데이터의 각 단위를 구분합니다. 또한 데이터 전송에 사용 가능한 경우에 지속적으로 전송 됩니다.

1 ("1")

1.5 ("1.5")

2 ("2")

XOffCharacter

데이터 형식: uint32

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 통신 구조| DCB| XoffChar")

전송 및 수신 모두에 대한 XOFF 문자의 값입니다. XOFF는 데이터 전송을 중지하는 소프트웨어 컨트롤입니다(RTS 및 CTS는 하드웨어 컨트롤임). XON은 전송을 다시 시작합니다.

XOffXMitThreshold

데이터 형식: uint32

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 통신 구조| DCB| XoffLim")

XOFF 문자를 보내기 전에 입력 버퍼에서 허용되는 최대 바이트 수입니다.

XOnCharacter

데이터 형식: uint32

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 통신 구조| DCB| XonChar")

전송 및 수신 모두에 대한 XON 문자의 값입니다. XON은 데이터 전송을 다시 시작하는 소프트웨어 컨트롤입니다(RTS 및 CTS는 하드웨어 컨트롤임). XOFF는 전송을 중지합니다.

XOnXMitThreshold

데이터 형식: uint32

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 통신 구조| DCB| XonLim")

XON 문자가 전송되기 전에 입력 버퍼에 허용되는 최소 바이트 수입니다. 이 속성은 XOffXMitThreshold 와 함께 작동하여 데이터가 전송되는 속도를 조절합니다.

XOnXOffInFlowControl

데이터 형식: uint32

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 통신 구조| DCB|fInX")

TRUE이면 수신 중에 XON/XOFF 흐름 제어가 사용됩니다. TRUE이면 입력 버퍼가 가득 찬 XOffXMitThreshold 바이트 내에 입력 버퍼가 들어오고 입력 버퍼가 비어 있는 XOnXMitThreshold 바이트 내에 오면 XOnCharacter 값이 전송될 때 XOffCharacter 값이 전송됩니다.

0

FALSE

1

TRUE

XOnXOffOutFlowControl

데이터 형식: uint32

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 통신 구조| DCB|fOutX")

XOnXOffOutFlowControl은 전송 중에 XON 또는 XOFF 흐름 제어를 사용할지 여부를 지정합니다. TRUE이면 XOffCharacter 값이 수신되면 전송이 중지되고 XOnCharacter 값이 수신되면 다시 시작됩니다.

설명

Win32_SerialPortConfiguration 클래스는 CIM_Setting 파생됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
네임스페이스	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

추가 정보

CIM_Setting

컴퓨터 시스템 하드웨어 클래스