CIM_CDROMDrive-Klasse (CIMWin32 WMI-Anbieter)
Die CIM_CDROMDrive-Klasse stellt ein CD-ROM-Laufwerk auf dem Computer dar.
Hinweis
Der Name des Laufwerks entspricht nicht dem dem Gerät zugewiesenen Buchstaben des logischen Laufwerks. Dies ist der Name des logischen Speichergeräts, das vom Laufwerk abhängig ist.
Wichtig
Die CIM-Klassen (Common Information Model) von DMTF (Distributed Management Task Force) sind die übergeordneten Klassen, auf denen WMI-Klassen erstellt werden. WMI unterstützt derzeit nur die CIM 2.x-Versionsschemas.
Die folgende Syntax wird durch MOF-Code (Managed Object Format) vereinfacht und schließt alle geerbten Eigenschaften ein. Eigenschaften werden in alphabetischer Reihenfolge und nicht in MOF-Reihenfolge aufgeführt.
Syntax
[Abstract, UUID("{8502C52B-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class CIM_CDROMDrive : CIM_MediaAccessDevice
{
string Caption;
string Description;
datetime InstallDate;
string Name;
string Status;
uint16 Availability;
uint32 ConfigManagerErrorCode;
boolean ConfigManagerUserConfig;
string CreationClassName;
string DeviceID;
uint16 PowerManagementCapabilities[];
boolean ErrorCleared;
string ErrorDescription;
uint32 LastErrorCode;
string PNPDeviceID;
boolean PowerManagementSupported;
uint16 StatusInfo;
string SystemCreationClassName;
string SystemName;
uint16 Capabilities[];
string CapabilityDescriptions[];
string CompressionMethod;
uint64 DefaultBlockSize;
string ErrorMethodology;
uint64 MaxBlockSize;
uint64 MaxMediaSize;
uint64 MinBlockSize;
boolean NeedsCleaning;
uint32 NumberOfMediaSupported;
};
Member
Die CIM_CDROMDrive-Klasse verfügt über die folgenden Membertypen:
Methoden
Die CIM_CDROMDrive-Klasse verfügt über diese Methoden.
| Methode | BESCHREIBUNG |
|---|---|
| Zurücksetzen | Fordert eine Zurücksetzung des logischen Geräts an. Nicht von WMI implementiert. |
| SetPowerState | Definiert den gewünschten Energiezustand für ein logisches Gerät und wann ein Gerät in diesen Zustand versetzt werden soll. Nicht von WMI implementiert. |
Eigenschaften
Die CIM_CDROMDrive-Klasse verfügt über diese Eigenschaften.
-
Verfügbarkeit
-
-
Datentyp: uint16
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("MIF. DMTF| Betriebszustand|003.5", "MIB. IETF| HOST-RESOURCES-MIB.hrDeviceStatus")
Verfügbarkeit und status des Geräts.
Diese Eigenschaft wird von CIM_LogicalDevice geerbt.
-
-
Sonstiges (1)
-
Unbekannt (2)
-
Running/Full Power (3)
-
Warnung (4)
-
Im Test (5)
-
Nicht zutreffend (6)
-
Ausschalten (7)
-
Offline (8)
-
Off Duty (9)
-
Beeinträchtigt (10)
-
Nicht installiert (11)
-
Installationsfehler (12)
-
Energiesparen – Unbekannt (13)
-
Es ist bekannt, dass sich das Gerät in einem Energiesparmodus befindet, aber seine genaue status ist unbekannt.
-
Energiesparen – Energiesparmodus (14)
-
Das Gerät befindet sich im Energiesparmodus, funktioniert aber weiterhin und kann eine beeinträchtigte Leistung aufweisen.
-
Energiesparen – Standby ( 15)
-
Das Gerät funktioniert nicht, konnte aber schnell zur vollen Leistung gebracht werden.
-
Stromversorgung (16)
-
Energiesparen – Warnung (17)
-
Das Gerät befindet sich in einem Warnzustand, aber auch im Energiesparmodus.
-
Angehalten (18)
-
Das Gerät wird angehalten.
-
Nicht bereit (19)
-
Das Gerät ist nicht bereit.
-
Nicht konfiguriert (20)
-
Das Gerät ist nicht konfiguriert.
-
Ruhen (21)
-
Das Gerät ist leise.
Capabilities
-
Datentyp: uint16-Array
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: ArrayType ("Indexed"), MappingStrings ("MIF. DMTF| Speichergeräte|001.9", "MIF. DMTF| Speichergeräte|001.11", "MIF. DMTF| Speichergeräte|001.12", "MIF. DMTF| Datenträger|003.7"), ModelCorrespondence ("CIM_MediaAccessDevice. CapabilityDescriptions")
Funktionen des Medienzugriffsgeräts.
Diese Eigenschaft wird von CIM_MediaAccessDevice geerbt.
Unbekannt (0)
Unbekannt
Sonstiges (1)
Sonstiges
Sequenzieller Zugriff (2)
Sequenzieller Zugriff.
Zufälliger Zugriff (3)
Random-Access.
Unterstützt Das Schreiben (4)
Schreiben.
Verschlüsselung (5)
Verschlüsselung
Komprimierung (6)
Komprimierung.
Unterstützt Entfernbare Medien (7)
Wechselmedien.
Manuelle Reinigung (8)
Manuelle Reinigung.
Automatische Reinigung (9)
Automatische Reinigung.
SMART-Benachrichtigung (10)
SMART-Benachrichtigung.
Unterstützt Dual Sided Media (11)
Unterscheidet ein Gerät, das auf beide Seiten dualer Medien zugreifen kann, von einem Gerät, das nur eine Seite liest und die Umstellung des Mediums erfordert.
Predismount-Auswurf nicht erforderlich (12)
Gibt an, dass die Medien nicht explizit vom Gerät ausgeworfen werden müssen, bevor ein Auswahlelement auf sie zugreift.
CapabilityDescriptions
-
Datentyp: Zeichenfolgenarray
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: ArrayType ("Indiziert"), ModelCorrespondence ("CIM_MediaAccessDevice. Funktionen")
Array von Freiformzeichenfolgen, das detaillierte Erklärungen für die Gerätefeatures enthält, die im Array "Funktionen" angegeben sind.
Hinweis
Jeder Eintrag dieses Arrays bezieht sich auf den Eintrag im Array Capabilities , das sich im gleichen Index befindet.
Diese Eigenschaft wird von CIM_MediaAccessDevice geerbt.
Caption
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MaxLen (64), DisplayName ("Caption")
Eine kurze Textbeschreibung des Objekts.
Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.
CompressionMethod
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
Freiformzeichenfolge, die den Algorithmus oder das Tool angibt, das zum Komprimieren der logischen Datei verwendet wird. Wenn es nicht möglich ist, das Komprimierungsschema zu beschreiben (da es unbekannt ist), verwenden Sie Folgendes:Wenn , verwenden Sie "Unbekannt". Wenn , verwenden Sie "Komprimiert". , verwenden Sie "Nicht komprimiert".
Diese Eigenschaft wird von CIM_MediaAccessDevice geerbt.
("Unbekannt")
Das Komprimierungsschema ist unbekannt oder nicht beschrieben.
("Komprimiert")
Die logische Datei ist komprimiert, aber das Komprimierungsschema ist unbekannt oder nicht beschrieben.
("Nicht komprimiert")
Wenn die logische Datei nicht komprimiert ist
ConfigManagerErrorCode
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Schema ("Win32")
Win32 Configuration Manager Fehlercode.
Diese Eigenschaft wird von CIM_LogicalDevice geerbt.
Dieses Gerät funktioniert ordnungsgemäß. (0)
Dieses Gerät ist nicht ordnungsgemäß konfiguriert. (1)
Windows kann den Treiber für dieses Gerät nicht laden. (2)
Der Treiber für dieses Gerät ist möglicherweise beschädigt, oder Ihr System verfügt über wenig Arbeitsspeicher oder andere Ressourcen. (3)
Dieses Gerät funktioniert nicht ordnungsgemäß. Einer der Treiber oder Ihre Registrierung ist möglicherweise beschädigt. (4)
Der Treiber für dieses Gerät benötigt eine Ressource, die Windows nicht verwalten kann. (5)
Die Startkonfiguration für dieses Gerät ist mit anderen Geräten in Konflikt geraten. (6)
Filter kann nicht gefiltert werden. (7)
Der Treiberladevorgang für das Gerät fehlt. (8)
Dieses Gerät funktioniert nicht ordnungsgemäß, da die steuernde Firmware die Ressourcen für das Gerät falsch meldet. (9)
Dieses Gerät kann nicht gestartet werden. (10)
Fehler bei diesem Gerät. (11)
Dieses Gerät kann nicht genügend freie Ressourcen finden, die es verwenden kann. (12)
Windows kann die Ressourcen dieses Geräts nicht überprüfen. (13)
Dieses Gerät kann erst ordnungsgemäß funktionieren, wenn Sie Ihren Computer neu starten. (14)
Dieses Gerät funktioniert nicht ordnungsgemäß, da wahrscheinlich ein Problem mit erneuter Enumeration vorliegt. (15)
Windows kann nicht alle von diesem Gerät verwendeten Ressourcen identifizieren. (16)
Dieses Gerät fragt nach einem unbekannten Ressourcentyp. (17)
Installieren Sie die Treiber für dieses Gerät neu. (18)
Fehler beim Verwenden des VxD-Ladeprogramms. (19)
Möglicherweise ist Ihre Registrierung beschädigt. (20)
Systemfehler: Versuchen Sie, den Treiber für dieses Gerät zu ändern. Wenn dies nicht funktioniert, lesen Sie Ihre Hardwaredokumentation. Windows entfernt dieses Gerät. (21)
Dieses Gerät ist deaktiviert. (22)
Systemfehler: Versuchen Sie, den Treiber für dieses Gerät zu ändern. Wenn dies nicht funktioniert, lesen Sie Ihre Hardwaredokumentation. (23)
Dieses Gerät ist nicht vorhanden, funktioniert nicht ordnungsgemäß oder hat nicht alle Treiber installiert. (24)
Windows richtet dieses Gerät weiterhin ein. (25)
Windows richtet dieses Gerät weiterhin ein. (26)
Dieses Gerät verfügt nicht über eine gültige Protokollkonfiguration. (27)
Die Treiber für dieses Gerät sind nicht installiert. (28)
Dieses Gerät ist deaktiviert, da die Firmware des Geräts nicht die erforderlichen Ressourcen bereitgestellt hat. (29)
Dieses Gerät verwendet eine Interrupt Request -Ressource (IRQ), die von einem anderen Gerät verwendet wird. (30)
Dieses Gerät funktioniert nicht ordnungsgemäß, da Windows die für dieses Gerät erforderlichen Treiber nicht laden kann. (31)
ConfigManagerUserConfig
-
Datentyp: Boolesch
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Schema ("Win32")
Bei TRUE verwendet das Gerät eine benutzerdefinierte Konfiguration.
Diese Eigenschaft wird von CIM_LogicalDevice geerbt.
CreationClassName
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: CIM_Key
Name der Klasse oder Unterklasse, die bei der Erstellung einer instance verwendet wird. Bei Verwendung mit anderen Schlüsseleigenschaften der -Klasse ermöglicht diese Eigenschaft die eindeutige Identifizierung aller Instanzen der -Klasse und ihrer Unterklassen.
Diese Eigenschaft wird von CIM_LogicalDevice geerbt.
DefaultBlockSize
-
Datentyp: uint64
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Einheiten ("Bytes")
Standardblockgröße in Byte für das Gerät.
Weitere Informationen zur Verwendung von uint64-Werten in Skripts finden Sie unter Skripterstellung in WMI.
Diese Eigenschaft wird von CIM_MediaAccessDevice geerbt.
Beschreibung
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: DisplayName ("Description")
Eine Textbeschreibung des Objekts.
Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.
DeviceID
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: CIM_Key
Adresse oder andere identifizierende Informationen, um das logische Gerät eindeutig zu benennen.
Diese Eigenschaft wird von CIM_LogicalDevice geerbt.
ErrorCleared
-
Datentyp: boolean
-
Zugriffstyp: Schreibgeschützt
Wenn TRUE, wird der in der LastErrorCode-Eigenschaft gemeldete Fehler jetzt gelöscht.
Diese Eigenschaft wird von CIM_LogicalDevice geerbt.
ErrorDescription
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
Eine Freiformzeichenfolge, die Informationen über den in der LastErrorCode-Eigenschaft aufgezeichneten Fehler und auszuführende Korrekturmaßnahmen bereitstellt.
Diese Eigenschaft wird von CIM_LogicalDevice geerbt.
ErrorMethodology
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
Freiformzeichenfolge, die die Typen der Fehlererkennung und -korrektur beschreibt, die vom Gerät unterstützt werden.
Diese Eigenschaft wird von CIM_MediaAccessDevice geerbt.
InstallDate
-
Datentyp: datetime
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Installationsdatum")
Gibt an, wann das Objekt installiert wurde. Das Fehlen eines Werts gibt nicht an, dass das Objekt nicht installiert ist.
Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.
LastErrorCode
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
Letzter Fehlercode, der vom logischen Gerät gemeldet wurde.
Diese Eigenschaft wird von CIM_LogicalDevice geerbt.
MaxBlockSize
-
Datentyp: uint64
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Einheiten ("Bytes")
Maximale Blockgröße in Bytes für Medien, auf die vom Gerät zugegriffen wird.
Weitere Informationen zur Verwendung von uint64-Werten in Skripts finden Sie unter Skripterstellung in WMI.
Diese Eigenschaft wird von CIM_MediaAccessDevice geerbt.
MaxMediaSize
-
Datentyp: uint64
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("MIF. DMTF| Sequenzielle Zugriffsgeräte|001.2"), Einheiten ("Kilobytes")
Maximale Größe der von diesem Gerät unterstützten Medien in Kilobyte. Kilobytes werden als Anzahl von Bytes interpretiert, die mit 1000 multipliziert werden (nicht die Anzahl von Bytes multipliziert mit 1024).
Weitere Informationen zur Verwendung von uint64-Werten in Skripts finden Sie unter Skripterstellung in WMI.
Diese Eigenschaft wird von CIM_MediaAccessDevice geerbt.
MinBlockSize
-
Datentyp: uint64
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Einheiten ("Bytes")
Minimale Blockgröße in Byte für Medien, auf die vom Gerät zugegriffen wird.
Weitere Informationen zur Verwendung von uint64-Werten in Skripts finden Sie unter Skripterstellung in WMI.
Diese Eigenschaft wird von CIM_MediaAccessDevice geerbt.
Name
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: DisplayName ("Name")
Bezeichnung, unter der das Objekt bekannt ist. Bei unterklassigen Klassen kann diese Eigenschaft als Schlüsseleigenschaft überschrieben werden.
Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.
NeedsCleaning
-
Datentyp: boolean
-
Zugriffstyp: Schreibgeschützt
Bei TRUE muss das Medienzugriffsgerät bereinigungen. Ob eine manuelle oder automatische Bereinigung möglich ist, wird in der Eigenschaft Capabilities-Array angegeben.
Diese Eigenschaft wird von CIM_MediaAccessDevice geerbt.
NumberOfMediaSupported
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
Maximale Anzahl von mehreren einzelnen Medien, die unterstützt oder eingefügt werden können.
Diese Eigenschaft wird von CIM_MediaAccessDevice geerbt.
PNPDeviceID
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Schema ("Win32")
Gibt den Win32-Plug & Play Gerätebezeichner des logischen Geräts an.
Beispiel: "*PNP030b"
Diese Eigenschaft wird von CIM_LogicalDevice geerbt.
PowerManagementCapabilities
-
Datentyp: uint16-Array
-
Zugriffstyp: Schreibgeschützt
Gibt die spezifischen energiebezogenen Funktionen des logischen Geräts an.
Diese Eigenschaft wird von CIM_LogicalDevice geerbt.
Unbekannt (0)
Die energiebezogenen Kapazitäten sind unbekannt.
Nicht unterstützt (1)
Energiebezogene Kapazitäten werden für dieses Gerät nicht unterstützt.
Deaktiviert (2)
Energiebezogene Kapazitäten wurden deaktiviert.
Aktiviert (3)
Die Energieverwaltungsfeatures sind derzeit aktiviert, aber der genaue Featuresatz ist unbekannt, oder die Informationen sind nicht verfügbar.
Energiesparmodi werden automatisch eingegeben (4)
Das Gerät kann seinen Energiezustand basierend auf der Nutzung oder anderen Kriterien ändern.
Power State Settable (5)
Die SetPowerState-Methode wird unterstützt. Diese Methode befindet sich in der übergeordneten CIM_LogicalDevice Klasse und kann implementiert werden. Weitere Informationen finden Sie unter Entwerfen von MOF-Klassen (Managed Object Format).
Power Cycling Wird unterstützt (6)
Die SetPowerState-Methode kann mit dem PowerState-Parameter aufgerufen werden, der auf 5 ("Power Cycle") festgelegt ist.
Timed Power On Supported (7)
Die SetPowerState-Methode kann aufgerufen werden, wobei der PowerState-Parameter auf 5 ("Power Cycle") und der Time-Parameter auf ein bestimmtes Datum und eine bestimmte Uhrzeit oder ein bestimmtes Intervall für das Einschalten festgelegt ist.
PowerManagementSupported
-
Datentyp: boolean
-
Zugriffstyp: Schreibgeschützt
Bei TRUE kann das Gerät energieverwaltet, d. h. in einen Energiesparmodus versetzt werden. Bei FALSE sollte der ganzzahlige Wert 1 ("Nicht unterstützt") der einzige Eintrag im PowerManagementCapabilities-Array sein.
Diese Eigenschaft gibt nicht an, ob Energieverwaltungsfeatures derzeit aktiviert sind oder wenn aktiviert, welche Features unterstützt werden. Weitere Informationen finden Sie im PowerManagementCapabilities-Array .
Diese Eigenschaft wird von CIM_LogicalDevice geerbt.
Status
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MaxLen (10), DisplayName ("Status")
Zeichenfolge, die die aktuelle status des Objekts angibt. Operative und nicht operative status können definiert werden. Operative status können "OK", "Degraded" und "Pred Fail" enthalten. "Pred Fail" gibt an, dass ein Element ordnungsgemäß funktioniert, aber einen Fehler vorhersagt (z. B. eine SMART-fähige Festplatte).
Nicht betriebsbereite status können "Error", "Starting", "Stopping" und "Service" enthalten. "Dienst" kann während der Datenträger-Spiegel-Resilvering, beim erneuten Laden einer Benutzerberechtigungsliste oder bei anderen administrativen Aufgaben angewendet werden. Nicht alle derartigen Arbeiten sind online, aber das verwaltete Element ist weder "OK" noch in einem der anderen Zustände.
Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.
Folgende Werte sind gültig:
OK ("OK")
Fehler ("Fehler")
Degraded ("Degraded")
Unbekannt ("Unbekannt")
Pred Fail ("Pred Fail")
Wird gestartet ("Wird gestartet")
Beenden ("Wird beendet")
Dienst ("Dienst")
Gestresst ("Gestresst")
NonRecover ("NonRecover")
Kein Kontakt ("Kein Kontakt")
Lost Comm ("Lost Comm")
StatusInfo
-
Datentyp: uint16
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("MIF. DMTF| Betriebszustand|003.3")
Status des logischen Geräts. Wenn diese Eigenschaft nicht für das logische Gerät gilt, sollte der Wert 5 ("Nicht zutreffend") verwendet werden.
Diese Eigenschaft wird von CIM_LogicalDevice geerbt.
Sonstiges (1)
Unbekannt (2)
Aktiviert (3)
Deaktiviert (4)
Nicht zutreffend (5)
SystemCreationClassName
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Propagiert ("CIM_System. CreationClassName"), CIM_Key
Der Name der Erstellungsklasse des Bereichssystems.
Diese Eigenschaft wird von CIM_LogicalDevice geerbt.
Systemname
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Propagiert ("CIM_System. Name"), CIM_Key
Der Name des Bereichssystems.
Diese Eigenschaft wird von CIM_LogicalDevice geerbt.
Bemerkungen
Die CIM_CDROMDrive-Klasse wird von CIM_MediaAccessDevice abgeleitet.
WMI implementiert diese Klasse nicht. Weitere Informationen zu Klassen, die von CIM_CDROMDrive abgeleitet werden, finden Sie unter Win32-Klassen.
Diese Dokumentation wird von den CIM-Klassenbeschreibungen abgeleitet, die von der DMTF veröffentlicht werden. Microsoft hat möglicherweise Änderungen vorgenommen, um kleinere Fehler zu korrigieren, den Microsoft SDK-Dokumentationsstandards zu entsprechen oder weitere Informationen bereitzustellen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
WindowsServer 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|