Classe MSFT_Disk
Rappresenta un disco di Windows.
Un oggetto MSFT_Disk modella il concetto del sistema operativo Windows di un dispositivo disco. Il disco può essere collegato direttamente al sistema del computer oppure può essere un disco virtuale esposto al sistema tramite l'uso di un provider di gestione archiviazione.
La sintassi seguente è semplificata dal codice MOF (Managed Object Format).
Sintassi
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;
};
Membri
La classe MSFT_Disk ha questi tipi di membri:
Metodi
La classe MSFT_Disk dispone di questi metodi.
| metodo | Descrizione |
|---|---|
| Cancella | Rimuove le informazioni sulla partizione e annulla l'inizializzazione di un disco, restituendolo a uno stato RAW. |
| ConvertStyle | Converte lo stile di partizione di un disco già inizializzato. |
| CreatePartition | Crea una partizione su un disco. |
| Initialize | Inizializza un disco RAW con uno stile di partizione specifico. |
| Offline | Porta offline il disco. |
| Online | Porta online il disco. |
| Aggiorna | Aggiorna le informazioni sul layout del disco memorizzate nella cache. |
| SetAttributes | Imposta gli attributi e le proprietà del disco. |
Proprietà
La classe MSFT_Disk ha queste proprietà.
AllocateSize
Tipo di dati: UInt64
Tipo di accesso: sola lettura
Qualificatori: obbligatorio, unità (byte)
Quantità di spazio, in byte, attualmente usata sul disco.
BootFromDisk
Tipo di dati: Boolean
Tipo di accesso: sola lettura
TRUE se il computer è configurato per l'avvio da questo disco. Nei computer con firmware BIOS, si tratta del primo disco rilevato dal firmware durante l'avvio. Nei computer che usano il firmware EFI, si tratta del disco che contiene la partizione di sistema EFI (ESP). Se non sono presenti dischi o se sono presenti più dischi con una partizione ESP, questa proprietà non è impostata per alcun disco.
BusType
Tipo di dati: UInt16
Tipo di accesso: sola lettura
Tipo di bus di I/O utilizzato dal disco.
| Valore | Significato |
|---|---|
| Sconosciuto 0 | Il tipo di bus è sconosciuto. |
| 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 |
| FIRMA di accesso condiviso 10 | SAS (Serial Attached SCSI) |
| SATA 11 | ATA seriale (SATA) |
| SD 12 | Secure Digital (SD) |
| MMC 13 | Scheda multimediale (MMC) |
| Virtual 14 | Questo valore è riservato per l'uso del sistema. |
| File supportato virtuale 15 | Virtual supportato da file |
| Spazi di archiviazione 16 | Spazi di archiviazione |
| NVMe 17 | NVMe |
FirmwareVersion
Tipo di dati: String
Tipo di accesso: sola lettura
Rappresentazione di stringa della versione del firmware del disco.
FriendlyName
Tipo di dati: String
Tipo di accesso: sola lettura
Qualificatori: obbligatorio
Stringa intuitiva e orientata alla visualizzazione per identificare il disco.
Guid
Tipo di dati: String
Tipo di accesso: sola lettura
Se PartitionStyle è GPT, questa proprietà contiene il GUID per il disco. Questa proprietà sarà NULL per tutti gli altri tipi di disco.
HealthStatus
Tipo di dati: UInt16
Tipo di accesso: sola lettura
Stato di integrità del dispositivo disco.
| Valore | Significato |
|---|---|
| Integro 0 | Il disco funziona normalmente. |
| Avviso 1 | Il disco è ancora funzionante, ma ha rilevato errori o problemi che richiedono l'intervento dell'amministratore. |
| Non integro 2 | Il volume non funziona, a causa di errori o errori. Il volume richiede un'attenzione immediata da parte di un amministratore. |
IsBoot
Tipo di dati: Boolean
Tipo di accesso: sola lettura
TRUE se il disco contiene la partizione di avvio.
IsClustered
Tipo di dati: Boolean
Tipo di accesso: sola lettura
TRUE se il disco viene usato in un ambiente cluster o FALSE in caso contrario.
IsOffline
Tipo di dati: Boolean
Tipo di accesso: sola lettura
TRUE se il disco è offline o FALSE in caso contrario.
IsReadOnly
Tipo di dati: Boolean
Tipo di accesso: sola lettura
TRUE se il disco è di sola lettura o FALSE se è di lettura/scrittura.
IsSystem
Tipo di dati: Boolean
Tipo di accesso: sola lettura
TRUE se il disco contiene la partizione di sistema o FALSE in caso contrario.
LargestFreeExtent
Tipo di dati: UInt64
Tipo di accesso: sola lettura
Qualificatori: unità (byte)
Blocco contiguo più grande di spazio libero sul disco. Si tratta anche della dimensione massima di una partizione che può essere creata sul disco.
Location
Tipo di dati: String
Tipo di accesso: sola lettura
Stringa contenente il percorso PnP del disco. Il formato di questa stringa dipende dal tipo di bus. Se il tipo di bus è SCSI, SAS o PCI RAID, il formato è AdapterPnpLocationPath#BusType(PPathIdTTargetId LLunId). Se il tipo di bus è IDE, ATA, PATA o SATA, il formato è AdapterPnpLocationPath#BusType(CPathIdTTargetId LLunId). Per una tabella che elenca le parti di questa stringa, vedere la sezione Osservazioni seguente.
Nota
Per le immagini Hyper-V e VHD, questa proprietà è NULL, perché il controller virtuale non restituisce il percorso del percorso.
Per altre informazioni su questa proprietà, vedere la sezione Osservazioni seguente.
LogicalSectorSize
Tipo di dati: UInt32
Tipo di accesso: sola lettura
Qualificatori: unità (byte)
Dimensioni del settore logico del disco, in byte. Ad esempio, un disco nativo 4K segnala 4096, mentre un disco emulato 512 segnala 512.
Produttore
Tipo di dati: String
Tipo di accesso: sola lettura
Rappresentazione di stringa del produttore hardware del disco.
Modello
Tipo di dati: String
Tipo di accesso: sola lettura
Rappresentazione di stringa del numero di modello del disco.
Numero
Tipo di dati: UInt32
Tipo di accesso: sola lettura
Numero del sistema operativo per il disco. Il disco 0 è in genere il dispositivo di avvio. I numeri di disco potrebbero non necessariamente rimanere invariati tra i riavvii.
NumberOfPartitions
Tipo di dati: UInt32
Tipo di accesso: sola lettura
Numero di partizioni create sul disco.
OfflineReason
Tipo di dati: UInt16
Tipo di accesso: sola lettura
Se IsOffline è TRUE, questa proprietà contiene il motivo per cui il disco è offline.
I possibili valori sono i seguenti.
| Valore | Significato |
|---|---|
| Criterio 1 | L'utente ha richiesto che il disco sia offline. |
| Percorso ridondante 2 | Il disco viene usato per l'I/O a più percorsi. |
| Snapshot 3 | Il disco è un disco snapshot. |
| Collisione 4 | Si è verificato un conflitto di firma o identificatore con un altro disco. |
| Esaurimento risorse 5 | Ci sono risorse insufficienti per portare online il disco. |
| Errori di scrittura critici 6 | Si sono verificati errori di scrittura critici sul disco. |
| Analisi dell'integrità dei dati richiesta 7 | È necessaria un'analisi dell'integrità dei dati. |
OperationalStatus
Tipo di dati: UInt16
Tipo di accesso: sola lettura
Stato operativo del dispositivo disco.
| Valore | Significato |
|---|---|
| Sconosciuto 0 | Lo stato operativo è sconosciuto. |
| Altri 1 | Un elemento OperationalStatus specifico del fornitore è stato specificato impostando la proprietà OtherOperationalStatusDescription. |
| OK 2 | Il disco risponde ai comandi ed è in uno stato operativo normale. |
| Degradato 3 | Il disco risponde ai comandi, ma non è in esecuzione in uno stato operativo ottimale. |
| Sottolineato 4 | Il disco funziona, ma richiede attenzione. Ad esempio, il disco potrebbe essere sovraccarico o surriscaldato. |
| Errore predittivo 5 | Il disco funziona, ma è probabile che si verifichi un errore nel prossimo futuro. |
| Errore 6 | Si è verificato un errore. |
| Errore non ripristinabile 7 | Si è verificato un errore non ripristinabile. |
| A partire da 8 | Il disco è in corso di avvio. |
| Arresto di 9 | Il disco è in corso di arresto. |
| Arrestato 10 | Il disco è stato arrestato o arrestato in modo pulito e ordinato. |
| Nel servizio 11 | Il disco viene configurato, gestito, pulito o gestito in altro modo. |
| Nessun contatto 12 | Il provider di archiviazione ha una conoscenza del disco, ma non è mai stato in grado di stabilire la comunicazione con esso. |
| Comunicazione persa 13 | Il provider di archiviazione ha una conoscenza del disco e lo ha contattato correttamente in passato, ma il disco non è attualmente raggiungibile. |
| Interrotto 14 | Analogamente a Arrestato, ad eccezione del fatto che il disco si arresta bruscamente e potrebbe richiedere la configurazione o la manutenzione. |
| Inattivo 15 | Il disco è raggiungibile, ma è inattivo. |
| Supporto dell'entità nell'errore 16 | Questo valore di stato non indica necessariamente problemi con il disco, ma indica che un altro dispositivo o connessione da cui dipende il disco potrebbe richiedere attenzione. |
| Completato 17 | Il disco ha completato un'operazione. Questo valore di stato deve essere combinato con OK, Error o Degraded, a seconda del risultato dell'operazione. |
| 0xD010 online | Nei sottosistemi di archiviazione basati su Windows questo indica che l'oggetto è online. |
| Non pronto 0xD011 | Nei sottosistemi di archiviazione basati su Windows questo indica che l'oggetto non è pronto. |
| Nessun 0xD012 multimediale | Nei sottosistemi di archiviazione basati su Windows questo indica che l'oggetto non dispone di supporti. |
| 0xD013 offline | Nei sottosistemi di archiviazione basati su Windows questo indica che l'oggetto è offline. |
| 0xD014 non riuscito | Nei sottosistemi di archiviazione basati su Windows questo indica che l'oggetto si trova in uno stato di errore. |
PartitionStyle
Tipo di dati: UInt16
Tipo di accesso: sola lettura
Qualificatori: obbligatorio
Stile di partizione utilizzato dal disco.
| Valore | Significato |
|---|---|
| Sconosciuto 0 | Lo stile della partizione è sconosciuto. |
| MBR 1 | MBR (Record di avvio principale, Master Boot Record) |
| GPT 2 | Tabella di partizione GUID (GPT) |
Percorso
Tipo di dati: String
Tipo di accesso: sola lettura
Qualificatori: obbligatorio
Percorso che può essere usato per aprire un handle del sistema operativo sul dispositivo disco.
PhysicalSectorSize
Tipo di dati: UInt32
Tipo di accesso: sola lettura
Qualificatori: unità (byte)
Dimensioni del settore fisico del disco, in byte. Ad esempio, sia i dischi nativi 4K che i dischi emulati 512 segnalano 4096.
ProvisioningType
Tipo di dati: UInt16
Tipo di accesso: sola lettura
Tipo di provisioning del dispositivo disco.
| Valore | Significato |
|---|---|
| Sconosciuto 0 | Lo schema di provisioning non è specificato. |
| Sottile 1 | Lo spazio di archiviazione per il disco viene allocato su richiesta. |
| Correzione 2 | L'archiviazione viene allocata al momento della creazione del disco. |
SerialNumber
Tipo di dati: String
Tipo di accesso: sola lettura
Rappresentazione di stringa del numero di serie del disco.
Firma
Tipo di dati: UInt32
Tipo di accesso: sola lettura
Se PartitionStyle è MBR, questa proprietà contiene la firma di partizione MBR. Questa proprietà sarà NULL per tutti gli altri tipi di disco.
Dimensione
Tipo di dati: UInt64
Tipo di accesso: sola lettura
Qualificatori: obbligatorio, unità (byte)
Dimensioni totali del disco, in byte.
UniqueId
Tipo di dati: String
Tipo di accesso: sola lettura
Identificatore del disco. Contiene la pagina VPD 0x83 informazioni che identificano in modo univoco il disco. I tipi seguenti sono accettati (in ordine di precedenza):
- 8 (stringa del nome SCSI)
- 3 (nome FCPH)
- 2 (EUI64)
- 1 (ID fornitore)
- 0 (specifico del fornitore)
Se il disco è un disco virtuale esposto, uniqueId viene usato per eseguire il mapping dell'associazione tra i due oggetti.
UniqueIdFormat
Tipo di dati: UInt16
Tipo di accesso: sola lettura
Qualificatori: valori ( "Vendor Specific", "Vendor Id", "EUI64", "FCPH Name", "SCSI Name String" ), ValueMap ("0", "1", "2", "3", "8")
Formato dell'identificatore del disco. Questa proprietà contiene il tipo di descrittore VPD Page 0x83 utilizzato per impostare la proprietà UniqueId .
Osservazioni:
Nella tabella seguente sono elencate le parti della stringa di percorso della posizione utilizzata nella proprietà Location .
| Parte percorso | Descrizione |
|---|---|
| AdapterPnpLocationPath | Percorso PnP dell'adapter. Questo viene recuperato chiamando la funzione SetupDiGetDeviceProperty , passando &DEVPKEY_Device_LocationPaths per il parametro PropertyKey . |
| BusType | Tipo di bus: ATA, RAID, SAS o SCSI. Nota: se il tipo di bus è IDE, PATA o SATA, viene visualizzato come ATA nella stringa del percorso della posizione. Se si tratta di RAID PCI, viene visualizzato come RAID. |
| PathId | Numero dell'autobus. Si tratta del valore del membro PathId della struttura SCSI_ADDRESS restituita dal codice di controllo IOCTL_SCSI_GET_ADDRESS . |
| TargetId | Numero del dispositivo di destinazione. Si tratta del valore del membro TargetId della struttura SCSI_ADDRESS restituita dal codice di controllo IOCTL_SCSI_GET_ADDRESS . |
| LunId | Numero del LUN. Si tratta del valore del membro Lun della struttura SCSI_ADDRESS restituita dal codice di controllo IOCTL_SCSI_GET_ADDRESS . |
La tabella seguente contiene esempi di percorsi di percorso.
| Tipo di bus | Percorso percorso di esempio |
|---|---|
| ATA | PCIROOT(0)#PCI(0100)#ATA(C01T03L00) |
| RAID | PCIROOT(0)#PCI(0200)#PCI(0003)#PCI(0100)#RAID(P02T00L00) |
| Firma di accesso condiviso | PCIROOT(1)#PCI(0300)#SAS(P00T03L00) |
| SCSI | PCIROOT(0)#PCI(1C00)#PCI(0000)#SCSI(P00T01L01) |
A partire da Windows 10: MSFT_Disk deriva da MSFT_StorageObject. Ora eredita la proprietà ObjectId, precedentemente proprietà di MSFT_Disk.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 8 [solo app desktop] |
| Server minimo supportato | Windows Server 2012 [solo app desktop] |
| Spazio dei nomi | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |