Condividi tramite

Classe Msvm_SerialController

  • Articolo

Rappresenta le funzionalità e la gestione del controller seriale. I controller seriali sono dispositivi logici sempre presenti in una macchina virtuale e quindi non vengono allocati tramite un pool di risorse. Un'istanza del controller seriale è sempre presente in una macchina virtuale. I controller seriali hanno un numero fisso di istanze di porta. Questa implementazione supporta due porte per controller.

Nota

I controller seriali sono facoltativi nelle macchine virtuali di seconda generazione.

La sintassi seguente è il codice MOF (Managed Object Format) semplificato e include tutte le proprietà ereditate.

Sintassi

[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;
};

Members

La classe Msvm_SerialController include questi tipi di membri:

Metodi

La classe Msvm_SerialController include questi metodi.

Metodo Descrizione
EnableDevice Questo metodo non è supportato.
OnlineDevice Questo metodo non è supportato.
QuiesceDevice Questo metodo non è supportato.
RequestStateChange Richiede una modifica dello stato.
Reimpostazione Reimposta il dispositivo.
RestoreProperties Questo metodo non è supportato.
SaveProperties Questo metodo non è supportato.
SetPowerState Questo metodo non è supportato.

Proprietà

La classe Msvm_SerialController ha queste proprietà.

Disponibilità aggiuntiva

Tipo di dati: matrice uint16

Tipo di accesso: sola lettura

Qualsiasi disponibilità e stato aggiuntivo del dispositivo. Questa proprietà viene ereditata da CIM_LogicalDevice.

Valore Significato
{ 6 }
6
 Non applicabile

Disponibilità

Tipo di dati: uint16

Tipo di accesso: sola lettura

Disponibilità primaria e stato del dispositivo. Questa proprietà viene ereditata da CIM_LogicalDevice.

Valore Significato
6
 Non applicabile

AvailableRequestedStates

Tipo di dati: matrice uint16

Tipo di accesso: sola lettura

Indica i valori possibili per il parametro RequestedState del metodo RequestStateChange . Questa proprietà viene ereditata da CIM_EnabledLogicalElement, ma non viene usata.

Capabilities

Tipo di dati: matrice uint16

Tipo di accesso: sola lettura

Buffering e altre funzionalità del controller seriale che potrebbero essere intrinseche nell'hardware del chip. Questa proprietà viene ereditata da CIM_SerialController.

FunzionalitàDescriptions

Tipo di dati: matrice di stringhe

Tipo di accesso: sola lettura

Matrice di stringhe free-form che forniscono spiegazioni più dettagliate per una delle funzionalità del controller seriale indicate nella matrice Funzionalità . Questa proprietà viene ereditata da CIM_SerialController.

Didascalia

Tipo di dati: stringa

Tipo di accesso: sola lettura

Breve descrizione dell'oggetto. Questa proprietà viene ereditata da CIM_ManagedElement.

CommunicationStatus

Tipo di dati: uint16

Tipo di accesso: sola lettura

Indica la capacità della strumentazione di comunicare con l'elemento gestito sottostante. Un valore Null indica che questa proprietà non è implementata. Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Sconosciuto (0)

Non disponibile (1)

Comunicazione OK (2)

Comunicazione persa (3)

Nessun contatto (4)

DMTF Riservato (..)

Fornitore riservato (0x8000.).

CreationClassName

Tipo di dati: stringa

Tipo di accesso: sola lettura

Nome della classe o della sottoclasse utilizzata nella creazione di un'istanza. Questa proprietà viene ereditata da CIM_LogicalDevice.

Descrizione

Tipo di dati: stringa

Tipo di accesso: sola lettura

Descrizione dell'oggetto . Questa proprietà viene ereditata da CIM_ManagedElement.

DetailedStatus

Tipo di dati: uint16

Tipo di accesso: sola lettura

Complimenta la proprietà PrimaryStatus con dettagli di stato aggiuntivi. Un valore Null indica che questa proprietà non è implementata. Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Non disponibile (0)

Nessuna informazione aggiuntiva (1)

Stressato (2)

Errore predittivo (3)

Errore non recuperabile (4)

Entità di supporto nell'errore (5)

DMTF Riservato (..)

Fornitore riservato (0x8000.).

Deviceid

Tipo di dati: stringa

Tipo di accesso: sola lettura

Questa proprietà viene ereditata da CIM_LogicalDevice ed è sempre impostata su "Microsoft:<GUID>".

ElementName

Tipo di dati: stringa

Tipo di accesso: sola lettura

Nome visualizzato per l'oggetto. Questa proprietà viene ereditata da CIM_ManagedElement.

EnabledDefault

Tipo di dati: uint16

Tipo di accesso: sola lettura

Configurazione predefinita o di avvio di un amministratore per lo stato abilitato di un elemento. Questa proprietà viene ereditata da CIM_EnabledLogicalElement.

Valore Significato
2
 Attivato

EnabledState

Tipo di dati: uint16

Tipo di accesso: sola lettura

Stati abilitati e disabilitati di un elemento. Può anche indicare le transizioni tra questi stati richiesti. Questa proprietà viene ereditata da CIM_EnabledLogicalElement.

Valore Significato
5
 Non applicabile

ErrorCleared

Tipo di dati: booleano

Tipo di accesso: sola lettura

Indica se l'errore segnalato nella proprietà LastErrorCode è ora cancellato. Questa proprietà viene ereditata da CIM_LogicalDevice, ma non viene usata.

ErrorDescription

Tipo di dati: stringa

Tipo di accesso: sola lettura

Stringa che fornisce altre informazioni sull'errore registrato nella proprietà LastErrorCode e informazioni su eventuali azioni correttive che possono essere eseguite. Questa proprietà viene ereditata da CIM_LogicalDevice, ma non viene usata.

HealthState

Tipo di dati: uint16

Tipo di accesso: sola lettura

Integrità corrente dell'elemento. Ciò esprime l'integrità di questo elemento, ma non necessariamente quella dei relativi sottocomponenti. I valori possibili sono da 0 a 30, dove 5 significa che l'elemento è completamente integro e 30 significa che l'elemento è completamente non funzionante. Questa proprietà viene ereditata da CIM_ManagedSystemElement.

IdentifyingDescriptions

Tipo di dati: matrice di stringhe

Tipo di accesso: sola lettura

Matrice di stringhe free-form che forniscono spiegazioni e dettagli dietro le voci nella matrice di proprietà OtherIdentifyingInfo . Questa proprietà viene ereditata da CIM_LogicalDevice e viene sempre impostata su Null.

InstallDate

Tipo di dati: datetime

Tipo di accesso: sola lettura

Data e ora di creazione della configurazione della macchina virtuale. Questa proprietà viene ereditata da CIM_ManagedSystemElement.

InstanceID

Tipo di dati: stringa

Tipo di accesso: sola lettura

Qualificatori: Chiave

Identifica in modo univoco un'istanza di questa classe. Questa proprietà viene ereditata da CIM_ManagedElement.

LastErrorCode

Tipo di dati: uint32

Tipo di accesso: sola lettura

L'ultimo codice di errore segnalato dal dispositivo logico. Questa proprietà viene ereditata da CIM_LogicalDevice, ma non viene usata.

MaxBaudRate

Tipo di dati: uint32

Tipo di accesso: sola lettura

Velocità massima di baud, in bit al secondo, supportata dal controller seriale. Questa proprietà viene ereditata da CIM_SerialController.

MaxNumberControl

Tipo di dati: uint32

Tipo di accesso: sola lettura

Numero massimo di entità indirizzabili direttamente supportate da questo controller. Se il numero è sconosciuto o illimitato, deve essere usato un valore pari a 0. Protocollo usato dal controller per accedere ai dispositivi controllati. Questa proprietà viene ereditata da CIM_Controller.

MaxQuiesceTime

Tipo di dati: uint64

Tipo di accesso: sola lettura

La proprietà è stata deprecata. Questa proprietà viene ereditata da CIM_LogicalDevice, ma non viene usata.

Nome

Tipo di dati: stringa

Tipo di accesso: sola lettura

Etichetta in base alla quale è noto l'oggetto. Questa proprietà viene ereditata da CIM_ManagedSystemElement e corrisponde alla proprietà ElementName .

OperatingStatus

Tipo di dati: uint16

Tipo di accesso: sola lettura

Fornisce informazioni sullo stato correnti per la condizione operativa dell'elemento e può essere utilizzata per fornire maggiori dettagli rispetto al valore della proprietà EnabledState . Un valore Null indica che questa proprietà non è implementata. Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Sconosciuto (0)

Non disponibile (1)

Manutenzione (2)

Avvio (3)

Arresto (4)

Arrestato (5)

Interrotto (6)

Dormiente (7)

Completato (8)

Migrazione (9)

Emigrazione (10)

Immigrating (11)

Creazione di snapshot (12)

Arresto (13)

In test (14)

Transizione (15)

In servizio (16)

DMTF Riservato (..)

Fornitore riservato (0x8000.. )

OperationalStatus

Tipo di dati: matrice uint16

Tipo di accesso: sola lettura

Stati correnti dell'oggetto. Questa proprietà viene ereditata da CIM_ManagedSystemElement.

OtherEnabledState

Tipo di dati: string

Tipo di accesso: sola lettura

Stato abilitato o disabilitato dell'elemento quando la proprietà EnabledState è impostata su 1 (Other). Questa proprietà deve essere impostata su Null quando EnabledState è un valore diverso da 1. Questa proprietà viene ereditata da CIM_EnabledLogicalElement.

OtherIdentifyingInfo

Tipo di dati: matrice di stringhe

Tipo di accesso: sola lettura

Eventuali dati aggiuntivi, oltre alle informazioni sull'ID dispositivo, che possono essere usati per identificare un dispositivo logico. Questa proprietà viene ereditata da CIM_LogicalDevice e viene sempre impostata su Null.

PowerManagementCapabilities

Tipo di dati: matrice uint16

Tipo di accesso: sola lettura

Funzionalità di risparmio energia del dispositivo. Questa proprietà viene ereditata da CIM_LogicalDevice, ma non viene utilizzata.

PowerManagementSupported

Tipo di dati: booleano

Tipo di accesso: sola lettura

Indica se il dispositivo può essere gestito dall'alimentazione. Questa proprietà viene ereditata da CIM_LogicalDevice, ma non viene utilizzata.

PowerOnHours

Tipo di dati: uint64

Tipo di accesso: sola lettura

Numero di ore consecutive attivate da questo dispositivo dall'ultimo ciclo di alimentazione. Questa proprietà viene ereditata da CIM_LogicalDevice, ma non viene utilizzata.

PrimaryStatus

Tipo di dati: uint16

Tipo di accesso: sola lettura

Fornisce informazioni generali sullo stato. Questa proprietà deve essere utilizzata insieme alla proprietà DetailedStatus per fornire lo stato di integrità generale e dettagliato dell'elemento e dei relativi sottocomponenti. Un valore Null indica che questa proprietà non è implementata. Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Sconosciuto (0)

OK (1)

Degradato (2)

Errore (3)

DMTF Riservato (..)

Fornitore riservato (0x8000.. )

ProtocolDescription

Tipo di dati: string

Tipo di accesso: sola lettura

Stringa che fornisce altre informazioni correlate al protocollo supportato dal controller. Questa proprietà viene ereditata da CIM_Controller.

ProtocolloSupported

Tipo di dati: uint16

Tipo di accesso: sola lettura

Protocollo utilizzato dal controller per accedere ai dispositivi controllati. Questa proprietà viene ereditata da CIM_Controller.

Valore Significato
26
 IEEE-488

RequestedState

Tipo di dati: uint16

Tipo di accesso: sola lettura

Ultimo stato richiesto o desiderato per l'elemento. Lo stato effettivo dell'elemento è rappresentato da EnabledState. Questa proprietà viene fornita per confrontare gli ultimi stati abilitati o disabilitati richiesti. Questa proprietà viene ereditata da CIM_EnabledLogicalElement.

Valore Significato
12
 Non applicabile

Sicurezza

Tipo di dati: uint16

Tipo di accesso: sola lettura

Sicurezza operativa per il controller. Questa proprietà viene ereditata da CIM_SerialController.

Valore Significato
3
 Nessuno

Status

Tipo di dati: stringa

Tipo di accesso: sola lettura

Stato corrente dell'oggetto. Questa proprietà viene ereditata da CIM_ManagedSystemElement, ma non viene usata.

StatusDescriptions

Tipo di dati: matrice di stringhe

Tipo di accesso: sola lettura

Stringhe che descrivono i vari valori della matrice OperationalStatus . Questa proprietà viene ereditata da CIM_ManagedSystemElement.

StatusInfo

Tipo di dati: uint16

Tipo di accesso: sola lettura

Stato corrente del dispositivo logico. Questa proprietà viene ereditata da CIM_LogicalDevice, ma non viene usata.

SystemCreationClassName

Tipo di dati: stringa

Tipo di accesso: sola lettura

Nome della classe di creazione del sistema di ambito. Questa proprietà viene ereditata da CIM_LogicalDevice.

Systemname

Tipo di dati: stringa

Tipo di accesso: sola lettura

Identificatore univoco per la macchina virtuale di ambito. Questa proprietà viene ereditata da CIM_LogicalDevice.

TimeOfLastReset

Tipo di dati: datetime

Tipo di accesso: sola lettura

Ultima volta che il controller è stato attivato. Questa proprietà viene ereditata da CIM_Controller.

TimeOfLastStateChange

Tipo di dati: datetime

Tipo di accesso: sola lettura

Data o ora in cui lo stato abilitato dell'elemento è stato modificato. Questa proprietà viene ereditata da CIM_EnabledLogicalElement e viene sempre impostata su Null.

TotalPowerOnHours

Tipo di dati: uint64

Tipo di accesso: sola lettura

Numero totale di ore di alimentazione del dispositivo. Questa proprietà viene ereditata da CIM_LogicalDevice, ma non viene usata.

Transizione diToState

Tipo di dati: uint16

Tipo di accesso: sola lettura

Indica lo stato di destinazione a cui viene eseguita la transizione dell'istanza. Questa proprietà viene ereditata da CIM_EnabledLogicalElement, ma non viene usata.

Commenti

L'accesso alla classe Msvm_SerialController potrebbe essere limitato dal filtro dell'account utente. Per altre informazioni, vedere Controllo account utente e WMI.

Requisiti

Requisito Valore
Client minimo supportato
 Windows 8 [solo app desktop]
Server minimo supportato
 Windows Server 2012 [solo app desktop]
Spazio dei nomi
 Root\Virtualization\V2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

Vedi anche

CIM_SerialController

CIM_SerialController

Classi di dispositivi seriali