Поделиться через

класс Win32_SerialPortConfiguration

  • Статья

Класс WMIWin32_SerialPortConfiguration представляет параметры для передачи данных через последовательный порт windows. Сюда входят конфигурации для установки подключения и проверки ошибок.

Следующий пример синтаксиса — упрощенный MOF-код, который включает все наследуемые свойства. Свойства перечислены в алфавитном порядке, а не в порядке 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 имеет следующие типы членов:

Элемент Property

Класс 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

Caption

Тип данных: string

Тип доступа: только для чтения

Квалификаторы: MaxLen (64)

Краткое текстовое описание текущего объекта.

Это свойство наследуется от CIM_Setting.

ContinueXMitOnXOff

Тип данных: boolean

Тип доступа: только для чтения

Квалификаторы: MappingStrings ("Win32API| | Структуры коммуникации| DCB|fTXContinueOnXoff")

Если значение TRUE, передача данных продолжается, когда входной буфер находится в пределах байтов XOffXMitThreshold и драйвер передал значение XOffChararcter , чтобы прекратить получение байтов. При значении FALSE передача не продолжается до тех пор, пока входной буфер не будет в пределах байтов XOnXMitThreshold пустым, а драйвер не передал значение XOnCharacter для возобновления приема.

CTSOutflowControl

Тип данных: boolean

Тип доступа: только для чтения

Квалификаторы: MappingStrings ("Win32API| | Структуры коммуникации| DCB|fOutxCtsFlow")

Если задано значение TRUE, перед передачей данных проверяется сигнал clear to send (CTS). CTS сообщает о том, что оба устройства в последовательном подключении готовы к передаче данных. Передача данных приостанавливается до тех пор, пока не будет дан сигнал CTS.

Описание

Тип данных: string

Тип доступа: только для чтения

Текстовое описание текущего объекта.

Это свойство наследуется от CIM_Setting.

ОтменитьNULLBytes

Тип данных: 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

Тип данных: string

Тип доступа: только для чтения

Квалификаторы: 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, последовательный порт занят.

имя;

Тип данных: string

Тип доступа: только для чтения

Квалификаторы: key, MaxLen (256), MappingStrings ("Win32Registry| | Hardware\\DeviceMap\\SerialComm")

Имя последовательного порта Windows.

Пример: "COM1"

Parity

Тип данных: string

Тип доступа: только для чтения

Квалификаторы: MappingStrings ("Win32API| Структуры связи| DCB| Четность")

Используемый метод проверки четности. Четность используется в качестве метода проверки ошибок, при котором дополнительный бит четности включается в каждую единицу данных. Затем получатель может проверить допустимость данных, подсчитывая заданные биты.

Нет ("Нет")

Проверка четности не используется.

Нечетные ("Нечетные")

Устанавливает бит четности так, чтобы число установленных битов всегда было нечетным.

Even ("Even")

Устанавливает бит четности так, чтобы число установленных битов всегда было четным.

Mark ("Mark")

Оставляет бит четности равным 1.

Пробел ("Пространство")

Оставляет для бита четности значение 0 (ноль).

ParityCheckEnabled

Тип данных: boolean

Тип доступа: только для чтения

Квалификаторы: MappingStrings ("Win32API| Структуры связи| DCB|fParity")

Если задано значение TRUE, проверка четности включена.

RTSFlowControlType

Тип данных: string

Тип доступа: только для чтения

Управление потоком запроса на отправку (RTS). RTS используется для обозначения того, что данные доступны для передачи.

Включить ("Включить")

RTS остается включено для сеанса передачи данных.

Disable ("Disable")

RTS игнорируется после получения первого сигнала RTS.

Подтверждение ("Рукопожатие")

RTS отключается, если буфер передачи заполнен более чем на три четверти, а RTS включается, если буфер заполнен менее чем на половину.

Переключение ("Переключение")

RTS включается, если есть данные, буферизированные для передачи.

SettingID

Тип данных: string

Тип доступа: только для чтения

Квалификаторы: MaxLen (256)

Идентификатор, по которому известен текущий объект.

Это свойство наследуется от CIM_Setting.

StopBits

Тип данных: string

Тип доступа: только для чтения

Квалификаторы: 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, значение XOffCharacter отправляется, когда входной буфер находится в пределах байтов XOffXMitThreshold после заполнения, а значение XOnCharacter отправляется, когда входной буфер попадает в байты XOnXMitThreshold пустого.

0

Ложь.

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

Классы оборудования компьютерной системы