Freigeben über

MSFT_Disk Klasse

  • Artikel

Stellt einen Windows-Datenträger dar.

Ein MSFT_Disk-Objekt modelliert das Windows-Betriebssystemkonzept eines Datenträgergeräts. Der Datenträger kann direkt an das Computersystem angefügt werden, oder es kann sich um einen virtuellen Datenträger handeln, der über die Verwendung eines Speicherverwaltungsanbieters für das System verfügbar gemacht wird.

Die folgende Syntax ist eine Vereinfachung des Codes im Managed Object Format (MOF).

Syntax

class MSFT_Disk : MSFT_StorageObject
{
  String  Path;
  String  Location;
  String  FriendlyName;
  String  UniqueId;
  UInt16  UniqueIdFormat;
  UInt32  Number;
  String  SerialNumber;
  String  FirmwareVersion;
  String  Manufacturer;
  String  Model;
  UInt64  Size;
  UInt64  AllocatedSize;
  UInt32  LogicalSectorSize;
  UInt32  PhysicalSectorSize;
  UInt64  LargestFreeExtent;
  UInt32  NumberOfPartitions;
  UInt16  ProvisioningType;
  UInt16  OperationalStatus;
  UInt16  HealthStatus;
  UInt16  BusType;
  UInt16  PartitionStyle;
  UInt32  Signature;
  String  Guid;
  Boolean IsOffline;
  UInt16  OfflineReason;
  Boolean IsReadOnly;
  Boolean IsSystem;
  Boolean IsClustered;
  Boolean IsBoot;
  Boolean BootFromDisk;
};

Member

Die MSFT_Disk-Klasse weist folgende Typen von Membern auf:

Methoden

Die MSFT_Disk Klasse weist diese Methoden auf.

Methode Beschreibung
Clear Entfernt Partitionsinformationen und hebt die Initialisierung eines Datenträgers auf und gibt ihn in einen RAW-Zustand zurück.
ConvertStyle Konvertiert den Partitionsstil eines bereits initialisierten Datenträgers.
CreatePartition Erstellt eine Partition auf einem Datenträger.
Initialize Initialisiert einen RAW-Datenträger mit einem bestimmten Partitionsstil.
Offline Nimmt den Datenträger offline.
Online Bringt die Festplatte online.
Aktualisieren Aktualisiert die Layoutinformationen des zwischengespeicherten Datenträgers.
SetAttributes Legt die Attribute und Eigenschaften des Datenträgers fest.

Eigenschaften

Die MSFT_Disk Klasse weist diese Eigenschaften auf.

AllocatedSize

Datentyp: UInt64

Zugriffstyp: Schreibgeschützt

Qualifizierer: Erforderlich, Einheiten (Bytes)

Der Speicherplatz in Bytes, der derzeit auf dem Datenträger verwendet wird.

BootFromDisk

Datentyp: Boolean

Zugriffstyp: Schreibgeschützt

TRUE , wenn der Computer so konfiguriert ist, dass er von diesem Datenträger gestartet wird. Auf Computern mit BIOS-Firmware ist dies der erste Datenträger, den die Firmware beim Start erkennt. Auf Computern mit EFI-Firmware ist dies der Datenträger, der die EFI-Systempartition (ESP) enthält. Wenn keine Datenträger vorhanden sind oder mehrere Datenträger mit einer ESP-Partition vorhanden sind, ist diese Eigenschaft nicht für einen Datenträger festgelegt.

BusType

Datentyp: UInt16

Zugriffstyp: Schreibgeschützt

Der vom Datenträger verwendete E/A-Bustyp.

Wert Bedeutung
Unknown 0 Der Bustyp ist unbekannt.
SCSI 1 SCSI
ATAPI 2 ATAPI
ATA 3 ATA
1394 4 IEEE 1394
SSA 5 SSA
Fibre Channel 6 Fibre Channel
USB 7 USB
RAID 8 RAID
iSCSI 9 iSCSI
SAS 10 Serial Attached SCSI (SAS)
SATA 11 Serial ATA (SATA)
SD 12 Secure Digital (SD)
MMC 13 Multimediakarte (MMC)
Virtual 14 Dieser Wert ist für die Systemnutzung reserviert.
Datei gesichert virtual 15 File-Backed Virtual
Speicherplätze 16 Speicherplätze
NVMe 17 NVMe

FirmwareVersion

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Eine Zeichenfolgendarstellung der Firmwareversion des Datenträgers.

FriendlyName

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Kennzeichner: Erforderlich

Eine benutzerfreundliche, anzeigeorientierte Zeichenfolge zum Identifizieren des Datenträgers.

Guid

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Wenn " PartitionStyle " GPT ist, enthält diese Eigenschaft die GUID für den Datenträger. Diese Eigenschaft ist NULL für alle anderen Datenträgertypen.

HealthStatus

Datentyp: UInt16

Zugriffstyp: Schreibgeschützt

Der Integritätsstatus des Datenträgergeräts.

Wert Bedeutung
Healthy 0 Der Datenträger funktioniert normal.
Warning 1 Der Datenträger funktioniert weiterhin, hat jedoch Fehler oder Probleme erkannt, die administratoreingriff erfordern.
Unhealthy 2 Das Volume funktioniert aufgrund von Fehlern oder Fehlern nicht. Das Volume muss von einem Administrator sofort beachtet werden.

IsBoot

Datentyp: Boolean

Zugriffstyp: Schreibgeschützt

TRUE , wenn der Datenträger die Startpartition enthält.

IsClustered

Datentyp: Boolescher Wert

Zugriffstyp: Schreibgeschützt

TRUE , wenn der Datenträger in einer gruppierten Umgebung verwendet wird, oder FALSE auf andere Weise.

IsOffline

Datentyp: Boolean

Zugriffstyp: Schreibgeschützt

TRUE, wenn der Datenträger offline oder FALSCH ist.

IsReadOnly

Datentyp: Boolescher Wert

Zugriffstyp: Schreibgeschützt

TRUE , wenn der Datenträger schreibgeschützt ist, oder FALSE , wenn er lese-/schreibgeschützt ist.

IsSystem

Datentyp: Boolean

Zugriffstyp: Schreibgeschützt

TRUE , wenn dieser Datenträger die Systempartition oder FALSE enthält.

LargestFreeExtent

Datentyp: UInt64

Zugriffstyp: Schreibgeschützt

Qualifizierer: Einheiten (Bytes)

Der größte zusammenhängende Block des freien Speicherplatzes auf dem Datenträger. Dies ist auch die größte Größe einer Partition, die auf dem Datenträger erstellt werden kann.

Location

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Eine Zeichenfolge, die den PnP-Speicherortpfad des Datenträgers enthält. Das Format dieser Zeichenfolge hängt vom Bustyp ab. Wenn der Bustyp SCSI, SAS oder PCI RAID ist, ist das Format AdapterPnpLocationPath#BusType(PPathIdTTargetIdLLunId). Wenn der Bustyp IDE, ATA, PATA oder SATA ist, lautet das Format AdapterPnpLocationPath#BusType(CPathIdTTargetIdLLunId). Im folgenden Abschnitt "Hinweise" finden Sie eine Tabelle, in der die Teile dieser Zeichenfolge aufgelistet sind.

Hinweis

Bei Hyper-V- und VHD-Bildern ist diese Eigenschaft NULL, da der virtuelle Controller nicht den Standortpfad zurückgibt.

Weitere Informationen zu dieser Eigenschaft finden Sie im folgenden Abschnitt "Hinweise".

LogicalSectorSize

Datentyp: UInt32

Zugriffstyp: Schreibgeschützt

Qualifizierer: Einheiten (Bytes)

Die logische Sektorgröße des Datenträgers in Byte. Beispielsweise meldet ein systemeigener 4K-Datenträger 4096, während ein emulierter 512-Datenträger 512 meldet.

Hersteller

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Eine Zeichenfolgendarstellung des Hardwareherstellers des Datenträgers.

Modell

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Eine Zeichenfolgendarstellung der Modellnummer des Datenträgers.

Anzahl

Datentyp: UInt32

Zugriffstyp: Schreibgeschützt

Die Nummer des Betriebssystems für den Datenträger. Datenträger 0 ist in der Regel das Startgerät. Datenträgernummern bleiben möglicherweise nicht unbedingt bei Neustarts gleich.

NumberOfPartitions

Datentyp: UInt32

Zugriffstyp: Schreibgeschützt

Die Anzahl der Partitionen, die auf dem Datenträger erstellt wurden.

OfflineReason

Datentyp: UInt16

Zugriffstyp: Schreibgeschützt

Wenn IsOffline WAHR ist, enthält diese Eigenschaft den Grund dafür, dass der Datenträger offline ist.

Einer der folgenden Werte:

Wert Bedeutung
Richtlinie 1 Der Benutzer hat den Datenträger aufgefordert, offline zu sein.
Redundanter Pfad 2 Der Datenträger wird für E/A mit mehreren Pfaden verwendet.
Momentaufnahme 3 Der Datenträger ist ein Momentaufnahmedatenträger.
Kollision 4 Es gab einen Signatur- oder Bezeichnerkonflikt mit einem anderen Datenträger.
Ressourcenauslastung 5 Es gab nicht genügend Ressourcen, um den Datenträger online zu bringen.
Kritische Schreibfehler 6 Es gab kritische Schreibfehler auf dem Datenträger.
Datenintegritätsscan erforderlich 7 Eine Datenintegritätsüberprüfung ist erforderlich.

OperationalStatus

Datentyp: UInt16

Zugriffstyp: Schreibgeschützt

Der Betriebsstatus des Datenträgergeräts.

Wert Bedeutung
Unknown 0 Der Status des Vorgangs ist unbekannt.
Other 1 Ein anbieterspezifischer OperationalStatus wurde durch Festlegen der Eigenschaft OtherOperationalStatusDescription angegeben.
OK 2 Der Datenträger reagiert auf Befehle und befindet sich in einem normalen Betriebszustand.
Degraded 3 Der Datenträger reagiert auf Befehle, wird jedoch nicht in einem optimalen Betriebszustand ausgeführt.
Stressed 4 Der Datenträger funktioniert, benötigt jedoch Aufmerksamkeit. Beispielsweise kann der Datenträger überlastet oder überhitzt werden.
Predictive Failure 5 Der Datenträger funktioniert, aber in Naher Zukunft tritt ein Fehler auf.
Error 6 Ein Fehler ist aufgetreten.
Non-Recoverable Error 7 Ein nicht wiederherstellbarer Fehler ist aufgetreten.
Starting 8 Der Datenträger wird gestartet.
Stopping 9 Der Datenträger wird beendet.
Stopped 10 Der Datenträger wurde sauber und geordnet beendet oder heruntergefahren.
In Service 11 Der Datenträger wird konfiguriert, verwaltet, bereinigt oder anderweitig verwaltet.
No Contact 12 Der Speicheranbieter verfügt über Kenntnisse des Datenträgers, konnte aber nie die Kommunikation damit herstellen.
Lost Communication 13 Der Speicheranbieter verfügt über Kenntnisse des Datenträgers und hat ihn in der Vergangenheit erfolgreich kontaktiert, der Datenträger ist jedoch zurzeit nicht erreichbar.
Aborted 14 Ähnlich wie "Stopped", mit der Ausnahme, dass der Datenträger abrupt beendet wurde und möglicherweise eine Konfiguration oder Wartung erforderlich ist.
Dormant 15 Der Datenträger ist erreichbar, ist aber inaktiv.
Supporting Entity in Error 16 Dieser Statuswert weist nicht unbedingt auf Probleme mit dem Datenträger hin, weist jedoch darauf hin, dass ein anderes Gerät oder eine andere Verbindung, von der der Datenträger abhängt, möglicherweise Aufmerksamkeit benötigt.
Completed 17 Der Datenträger hat einen Vorgang abgeschlossen. Dieser Statuswert sollte abhängig vom Ergebnis des Vorgangs mit OK, Error oder Degraded kombiniert werden.
Online-0xD010 In Windows-basierten Speichersubsystemen gibt dies an, dass das Objekt online ist.
Nicht bereit 0xD011 In Windows-basierten Speichersubsystemen gibt dies an, dass das Objekt nicht bereit ist.
Keine Medien-0xD012 In Windows-basierten Speichersubsystemen gibt dies an, dass das Objekt keine Medien vorhanden ist.
Offline-0xD013 In Windows-basierten Speichersubsystemen gibt dies an, dass das Objekt offline ist.
Fehler beim 0xD014 In Windows-basierten Speichersubsystemen gibt dies an, dass sich das Objekt in einem fehlerhaften Zustand befindet.

PartitionStyle

Datentyp: UInt16

Zugriffstyp: Schreibgeschützt

Kennzeichner: Erforderlich

Der vom Datenträger verwendete Partitionsstil.

Wert Bedeutung
Unknown 0 Der Partitionsstil ist unbekannt.
MBR 1 Master Boot Record (MBR)
GPT 2 GUID-Partitionstabelle (GPT)

Pfad

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Kennzeichner: Erforderlich

Ein Pfad, der zum Öffnen eines Betriebssystemhandles auf dem Datenträgergerät verwendet werden kann.

PhysicalSectorSize

Datentyp: UInt32

Zugriffstyp: Schreibgeschützt

Qualifizierer: Einheiten (Bytes)

Die Größe des physischen Sektors des Datenträgers in Byte. Beispielsweise melden sowohl 4K-systemeigene Datenträger als auch 512 emulierte Datenträger 4096.

ProvisioningType

Datentyp: UInt16

Zugriffstyp: Schreibgeschützt

Der Bereitstellungstyp des Datenträgergeräts.

Wert Bedeutung
Unknown 0 Das Bereitstellungsschema ist nicht angegeben.
Thin 1 Der Speicher für den Datenträger wird bei Bedarf zugewiesen.
Fixed 2 Der Speicher wird zugewiesen, wenn der Datenträger erstellt wird.

SerialNumber

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Eine Zeichenfolgendarstellung der Seriennummer des Datenträgers.

Signature

Datentyp: UInt32

Zugriffstyp: Schreibgeschützt

Wenn " PartitionStyle " MBR ist, enthält diese Eigenschaft die MBR-Partitionssignatur. Diese Eigenschaft ist NULL für alle anderen Datenträgertypen.

Größe

Datentyp: UInt64

Zugriffstyp: Schreibgeschützt

Qualifizierer: Erforderlich, Einheiten (Bytes)

Gesamtgröße des Datenträgers in Byte.

UniqueId

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Der Datenträgerbezeichner. Dies enthält die VPD-Seite 0x83 Informationen, die diesen Datenträger eindeutig identifizieren. Die folgenden Typen werden akzeptiert (in der Reihenfolge der Rangfolge):

  • 8 (SCSI-Namenszeichenfolge)
  • 3 (FCPH-Name)
  • 2 (EUI64)
  • 1 (Anbieter-ID)
  • 0 (Anbieterspezifisch)

Wenn der Datenträger ein verfügbar gemachter virtueller Datenträger ist, wird die UniqueId verwendet, um die Zuordnung zwischen den beiden Objekten zuzuordnen.

UniqueIdFormat

Datentyp: UInt16

Zugriffstyp: Schreibgeschützt

Qualifizierer: Werte ( "Vendor Specific", "Vendor Id", "EUI64", "FCPH Name", "SCSI Name String" ), ValueMap ("0", "1", "2", "3", "8")

Das Format des Datenträgerbezeichners. Diese Eigenschaft enthält den VPD Page-0x83 Deskriptortyp, der zum Festlegen der UniqueId-Eigenschaft verwendet wurde.

Hinweise

In der folgenden Tabelle sind die Teile der Speicherortpfadzeichenfolge aufgeführt, die in der Location-Eigenschaft verwendet wird.

Speicherortpfadteil Beschreibung
AdapterPnpLocationPath Der PnP-Speicherortpfad des Adapters. Dies wird durch Aufrufen der SetupDiGetDeviceProperty-Funktion abgerufen, wobei &DEVPKEY_Device_LocationPaths für den PropertyKey-Parameter übergeben wird.
BusType Der Bustyp: ATA, RAID, SAS oder SCSI. Hinweis: Wenn der Bustyp IDE, PATA oder SATA ist, wird er als ATA in der Pfadzeichenfolge für den Standort angezeigt. Wenn es sich um PCI RAID handelt, wird sie als RAID angezeigt.
PathId Die Nummer des Busses. Dies ist der Wert des PathId-Members der SCSI_ADDRESS Struktur, die vom IOCTL_SCSI_GET_ADDRESS-Steuerelementcode zurückgegeben wird.
TargetId Die Nummer des Zielgeräts. Dies ist der Wert des TargetId-Members der SCSI_ADDRESS Struktur, die vom IOCTL_SCSI_GET_ADDRESS-Steuerelementcode zurückgegeben wird.
LunId Die Nummer des LUN. Dies ist der Wert des Lun-Elements der SCSI_ADDRESS Struktur, die vom IOCTL_SCSI_GET_ADDRESS-Steuerelementcode zurückgegeben wird.

Die folgende Tabelle enthält Beispiele für Speicherortpfade.

Bustyp Beispielpfad für Speicherorte
ATA PCIROOT(0)#PCI(0100)#ATA(C01T03L00)
RAID PCIROOT(0)#PCI(0200)#PCI(0003)#PCI(0100)#RAID(P02T00L00)
SAS PCIROOT(1)#PCI(0300)#SAS(P00T03L00)
SCSI PCIROOT(0)#PCI(1C00)#PCI(0000)#SCSI(P00T01L01)

Ab Windows 10: MSFT_Disk abgeleitet von MSFT_StorageObject. Sie erbt nun die Eigenschaft ObjectId, die früher eine Eigenschaft von MSFT_Disk war.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [nur Desktop-Apps]
Namespace Root\Microsoft\Windows\Storage
MOF Storagewmi.mof