Класс Msvm_SerialController

Статья
06/13/2023

Представляет возможности последовательного контроллера и управление ими. Последовательные контроллеры — это логические устройства, которые всегда присутствуют в виртуальной машине и, следовательно, не выделяются через пул ресурсов. На виртуальной машине всегда присутствует один экземпляр последовательного контроллера. Последовательные контроллеры имеют фиксированное количество экземпляров портов. Эта реализация поддерживает два порта на контроллер.

Примечание

Последовательные контроллеры являются необязательными для виртуальных машин поколения 2.

Следующий синтаксис представляет собой упрощенный код формата управляемого объекта (MOF) и включает все унаследованные свойства.

Синтаксис

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_SerialController : CIM_SerialController
{
  string   InstanceID;
  string   Caption = "Serial Controller";
  string   Description = "Microsoft Virtual Serial Controller";
  string   ElementName = "Serial Controller";
  datetime InstallDate;
  string   Name = "Serial Controller";
  uint16   OperationalStatus[] = { 2 };
  string   StatusDescriptions[] = { "OK" };
  string   Status;
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  uint16   EnabledState = 5;
  string   OtherEnabledState;
  uint16   RequestedState = 12;
  uint16   EnabledDefault = 2;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   SystemCreationClassName = "Msvm_ComputerSystem";
  string   SystemName;
  string   CreationClassName = "Msvm_SerialController";
  string   DeviceID;
  boolean  PowerManagementSupported;
  uint16   PowerManagementCapabilities[];
  uint16   Availability = 6;
  uint16   StatusInfo;
  uint32   LastErrorCode;
  string   ErrorDescription;
  boolean  ErrorCleared;
  string   OtherIdentifyingInfo[];
  uint64   PowerOnHours;
  uint64   TotalPowerOnHours;
  string   IdentifyingDescriptions[];
  uint16   AdditionalAvailability[] = { 6 };
  uint64   MaxQuiesceTime;
  datetime TimeOfLastReset;
  uint16   ProtocolSupported = 26;
  uint32   MaxNumberControlled = 2;
  string   ProtocolDescription;
  uint16   Capabilities[] = { 5 };
  string   CapabilityDescriptions[] = { "16550 compatible" };
  uint32   MaxBaudRate = 115200;
  uint16   Security = 3;
};

Члены

Класс Msvm_SerialController имеет следующие типы членов:

Методы
Свойства

Методы

Класс Msvm_SerialController содержит следующие методы.

Метод	Описание
EnableDevice	Этот метод не поддерживается.
OnlineDevice	Этот метод не поддерживается.
QuiesceDevice	Этот метод не поддерживается.
RequestStateChange	Запрашивает изменение состояния.
Reset	Сбрасывает устройство.
RestoreProperties	Этот метод не поддерживается.
Saveproperties	Этот метод не поддерживается.
SetPowerState	Этот метод не поддерживается.

Свойства

Класс Msvm_SerialController имеет следующие свойства.

AdditionalAvailability

Тип данных: массив uint16
Тип доступа: только для чтения

Любые дополнительные сведения о доступности и состоянии устройства. Это свойство наследуется от CIM_LogicalDevice.

Значение	Значение
{ 6 }
6	Неприменимо

Доступность

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

Основная доступность и состояние устройства. Это свойство наследуется от CIM_LogicalDevice.

Значение	Значение
6	Неприменимо

AvailableRequestedStates

Тип данных: массив uint16
Тип доступа: только для чтения

Указывает возможные значения для параметра RequestedState метода RequestStateChange . Это свойство наследуется от CIM_EnabledLogicalElement, но не используется.

Capabilities

Тип данных: массив uint16
Тип доступа: только для чтения

Буферизация и другие возможности последовательного контроллера, которые могут быть присущи оборудованию микросхемы. Это свойство наследуется от CIM_SerialController.

Описания возможностей

Тип данных: строковый массив
Тип доступа: только для чтения

Массив строк свободной формы, предоставляющий более подробные объяснения для любой из функций последовательного контроллера, указанных в массиве Capabilities . Это свойство наследуется от CIM_SerialController.

Caption

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

Краткое описание объекта. Это свойство наследуется от CIM_ManagedElement.

CommunicationStatus

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

Указывает на способность инструментирования взаимодействовать с базовым управляемым элементом. Значение NULL указывает, что это свойство не реализовано. Это свойство наследуется от CIM_ManagedSystemElement.

Неизвестно (0)
Недоступно (1)
Связь ОК (2)
Потерянная связь (3)
Нет контакта (4)
DmTF Reserved (..)
Зарезервировано поставщиком (0x8000.. )

CreationClassName

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

Имя класса или подкласса, используемого при создании экземпляра. Это свойство наследуется от CIM_LogicalDevice.

Описание

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

Описание объекта. Это свойство наследуется от CIM_ManagedElement.

DetailedStatus

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

Дополняет свойство PrimaryStatus дополнительными сведениями о состоянии. Значение NULL указывает, что это свойство не реализовано. Это свойство наследуется от CIM_ManagedSystemElement.

Недоступно (0)
Нет дополнительной информации (1)
Подчеркнуто (2)
Прогнозный сбой (3)
Невосстанавливаемая ошибка (4)
Ошибка поддержки сущности (5)
Зарезервировано DMTF (..)
Зарезервировано поставщиком (0x8000.. )

DeviceID

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

Это свойство наследуется от CIM_LogicalDevice и всегда имеет значение "Microsoft:<GUID>".

ElementName

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

Отображаемое имя объекта. Это свойство наследуется от CIM_ManagedElement.

EnabledDefault

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

Конфигурация по умолчанию или запуска администратора для включенного состояния элемента. Это свойство наследуется от CIM_EnabledLogicalElement.

Значение	Значение
2	Активировано

EnabledState

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

Включенные и отключенные состояния элемента. Он также может указывать на переходы между этими запрошенными состояниями. Это свойство наследуется от CIM_EnabledLogicalElement.

Значение	Значение
5	Неприменимо

ErrorCleared

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

Указывает, была ли теперь снята ошибка, сообщаемая в свойстве LastErrorCode . Это свойство наследуется от CIM_LogicalDevice, но не используется.

ErrorDescription

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

Строка, которая предоставляет дополнительные сведения об ошибке, записанной в свойстве LastErrorCode , и сведения о любых корректирующих действиях, которые могут быть выполнены. Это свойство наследуется от CIM_LogicalDevice, но не используется.

HealthState

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

Текущая работоспособность элемента. Это выражает работоспособность этого элемента, но не обязательно его подкомпонентов. Возможные значения: от 0 до 30, где 5 означает, что элемент полностью работоспособен, а 30 означает, что элемент является полностью нефункциональным. Это свойство наследуется от CIM_ManagedSystemElement.

IdentifyingDescriptions

Тип данных: строковый массив
Тип доступа: только для чтения

Массив строк свободной формы, которые предоставляют пояснения и сведения о записях в массиве свойств OtherIdentifyingInfo . Это свойство наследуется от CIM_LogicalDevice и всегда имеет значение Null.

InstallDate

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

Дата и время создания конфигурации виртуальной машины. Это свойство наследуется от CIM_ManagedSystemElement.

InstanceID

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: Ключ

Уникально идентифицирует экземпляр этого класса. Это свойство наследуется от CIM_ManagedElement.

LastErrorCode

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

Последний код ошибки, сообщаемый логическим устройством. Это свойство наследуется от CIM_LogicalDevice, но не используется.

MaxBaudRate

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

Максимальная скорость передачи данных (в битах в секунду), поддерживаемая последовательным контроллером. Это свойство наследуется от CIM_SerialController.

MaxNumberControlled

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

Максимальное количество напрямую адресуемых сущностей, поддерживаемых этим контроллером. Если число неизвестно или неограниченно, следует использовать значение 0. Протокол, используемый контроллером для доступа к управляемым устройствам. Это свойство наследуется от CIM_Controller.

MaxQuiesceTime

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

Это свойство использовать не рекомендуется. Это свойство наследуется от CIM_LogicalDevice, но не используется.

имя;

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

Метка, по которой известен объект. Это свойство наследуется от CIM_ManagedSystemElement и совпадает со свойством ElementName .

OperatingStatus

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

Предоставляет сведения о текущем состоянии для рабочего состояния элемента и может использоваться для предоставления дополнительных сведений о значении свойства EnabledState . Значение NULL указывает, что это свойство не реализовано. Это свойство наследуется от CIM_ManagedSystemElement.

Неизвестно (0)
Недоступно (1)
Обслуживание (2)
Начиная ( 3)
Остановка (4)
Остановлено (5)
Прервано (6)
Неактивный (7)
Завершено (8)
Миграция (9)
Эмигрирование (10)
Иммигрирование (11)
Создание моментальных снимков (12)
Завершение работы (13)
В тесте (14)
Переход ( 15)
В службе (16)
Зарезервировано DMTF (..)
Зарезервировано поставщиком (0x8000.. )

OperationalStatus

Тип данных: массив uint16
Тип доступа: только для чтения

Текущие состояния объекта. Это свойство наследуется от CIM_ManagedSystemElement.

OtherEnabledState

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

Состояние "Включено" или "Отключено" элемента, когда свойству EnabledState присвоено значение 1 (Other). Это свойство должно иметь значение Null , если EnabledState имеет любое значение, отличное от 1. Это свойство наследуется от CIM_EnabledLogicalElement.

OtherIdentifyingInfo

Тип данных: строковый массив
Тип доступа: только для чтения

Любые дополнительные данные, помимо сведений об идентификаторе устройства, которые можно использовать для идентификации логического устройства. Это свойство наследуется от CIM_LogicalDevice и всегда имеет значение Null.

PowerManagementCapabilities

Тип данных: массив uint16
Тип доступа: только для чтения

Возможности управления питанием устройства. Это свойство наследуется от CIM_LogicalDevice, но не используется.

PowerManagementSupported

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

Указывает, можно ли управлять питанием устройства. Это свойство наследуется от CIM_LogicalDevice, но не используется.

PowerOnHours

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

Количество последовательных часов, в течение которых это устройство включается с момента последнего цикла питания. Это свойство наследуется от CIM_LogicalDevice, но не используется.

PrimaryStatus

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

Предоставляет сведения о состоянии высокого уровня. Это свойство следует использовать вместе со свойством DetailedStatus , чтобы обеспечить высокий уровень и подробное состояние работоспособности элемента и его подкомпонентов. Значение NULL указывает, что это свойство не реализовано. Это свойство наследуется от CIM_ManagedSystemElement.

Неизвестно (0)
ОК (1)
Понижение производительности (2)
Ошибка (3)
Зарезервировано DMTF (..)
Зарезервировано поставщиком (0x8000.. )

Описание протокола

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

Строка, которая предоставляет дополнительные сведения, связанные с протоколом, поддерживаемым контроллером. Это свойство наследуется от CIM_Controller.

ProtocolSupported

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

Протокол, используемый контроллером для доступа к управляемым устройствам. Это свойство наследуется от CIM_Controller.

Значение	Значение
26	IEEE-488

RequestedState

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

Последнее запрошенное или требуемое состояние элемента. Фактическое состояние элемента представлено EnabledState. Это свойство предоставляется для сравнения последних запрошенных и текущих включенных или отключенных состояний. Это свойство наследуется от CIM_EnabledLogicalElement.

Значение	Значение
12	Неприменимо

Безопасность

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

Операционная безопасность контроллера. Это свойство наследуется от CIM_SerialController.

Значение	Значение
3	Нет

Состояние

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

Текущее состояние объекта. Это свойство наследуется от CIM_ManagedSystemElement, но не используется.

Описания состояния

Тип данных: строковый массив
Тип доступа: только для чтения

Строки, описывающие различные значения массива OperationalStatus . Это свойство наследуется от CIM_ManagedSystemElement.

StatusInfo

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

Текущее состояние логического устройства. Это свойство наследуется от CIM_LogicalDevice, но не используется.

SystemCreationClassName

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

Имя класса создания системы области. Это свойство наследуется от CIM_LogicalDevice.

SystemName

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

Уникальный идентификатор виртуальной машины с областью действия. Это свойство наследуется от CIM_LogicalDevice.

TimeOfLastReset

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

Время последнего включения контроллера. Это свойство наследуется от CIM_Controller.

TimeOfLastStateChange

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

Дата или время последнего изменения включенного состояния элемента. Это свойство наследуется от CIM_EnabledLogicalElement и всегда имеет значение Null.

TotalPowerOnHours

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

Общее количество часов питания этого устройства. Это свойство наследуется от CIM_LogicalDevice, но не используется.

TransitioningToState

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

Указывает целевое состояние, в которое переходит экземпляр. Это свойство наследуется от CIM_EnabledLogicalElement, но не используется.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8 [только классические приложения]
Минимальная версия сервера	Windows Server 2012 [только классические приложения]
Пространство имен	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

См. также раздел

CIM_SerialController
CIM_SerialController
Классы последовательных устройств

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