clase MSFT_Disk

Artículo
07/08/2024

Representa un disco de Windows.

Un MSFT_Disk objeto modela el concepto del sistema operativo Windows de un dispositivo de disco. El disco se puede conectar directamente al sistema informático o puede ser un disco virtual expuesto al sistema mediante el uso de un proveedor de administración de almacenamiento.

La siguiente sintaxis se simplifica a partir del código de formato de objeto administrado (MOF).

Sintaxis

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

Miembros

La clase MSFT_Disk tiene estos tipos de miembros:

Métodos
Propiedades

Métodos

La clase MSFT_Disk tiene estos métodos.

Method	Descripción
Borrar	Quita la información de partición y anula la inicialización de un disco y la devuelve a un estado RAW.
ConvertStyle	Convierte el estilo de partición de un disco ya inicializado.
CreatePartition	Crea una partición en un disco.
Initialize	Inicializa un disco RAW con un estilo de partición determinado.
Offline	Desconecta el disco.
En línea	Pone el disco en línea.
Actualizar	Actualiza la información de diseño del disco almacenado en caché.
SetAttributes	Establece los atributos y propiedades del disco.

Propiedades

La clase MSFT_Disk tiene estas propiedades.

AllocatedSize

Tipo de datos: UInt64

Tipo de acceso: solo lectura

Calificadores: obligatorio, unidades (bytes)

Cantidad de espacio, en bytes, que se usa actualmente en el disco.

BootFromDisk

Tipo de datos: booleano

Tipo de acceso: solo lectura

TRUE si el equipo está configurado para iniciarse desde este disco. En equipos con firmware bios, este es el primer disco que detecta el firmware durante el inicio. En los equipos que usan firmware EFI, este es el disco que contiene la partición del sistema EFI (ESP). Si no hay discos o si hay varios discos con una partición ESP, esta propiedad no se establece para ningún disco.

BusType

Tipo de datos: UInt16

Tipo de acceso: solo lectura

Tipo de bus de E/S usado por el disco.

Valor	Significado
Unknown 0	El tipo de bus es desconocido.
SCSI 1	SCSI
ATAPI 2	ATAPI
ATA 3	ATA
1394 4	IEEE 1394
SSA 5	SSA
Canal de fibra 6	Canal de fibra
USB 7	USB
RAID 8	RAID
iSCSI 9	iSCSI
SAS 10	SCSI conectada en serie (SAS)
SATA 11	ATA serie (SATA)
SD 12	Secure Digital (SD)
MMC 13	Tarjeta multimedia (MMC)
Virtual 14	Este valor está reservado para uso por el sistema.
Archivo con copia de seguridad virtual 15	Virtual con copia de seguridad de archivos
Espacios de almacenamiento 16	Espacios de almacenamiento
NVMe 17	NVMe

FirmwareVersion

Tipo de datos: String

Tipo de acceso: solo lectura

Representación de cadena de la versión de firmware del disco.

FriendlyName

Tipo de datos: String

Tipo de acceso: solo lectura

Calificadores: Required

Cadena orientada a la visualización fácil de usar para identificar el disco.

GUID

Tipo de datos: String

Tipo de acceso: solo lectura

Si PartitionStyle es GPT, esta propiedad contiene el GUID del disco. Esta propiedad será NULL para todos los demás tipos de disco.

HealthStatus

Tipo de datos: UInt16

Tipo de acceso: solo lectura

Estado de mantenimiento del dispositivo de disco.

Valor	Significado
Healthy 0	El disco funciona normalmente.
Warning 1	El disco sigue funcionando, pero ha detectado errores o problemas que requieren intervención del administrador.
Unhealthy 2	El volumen no funciona, debido a errores o errores. El volumen necesita atención inmediata de un administrador.

IsBoot

Tipo de datos: booleano

Tipo de acceso: solo lectura

TRUE si el disco contiene la partición de arranque.

IsClustered

Tipo de datos: booleano

Tipo de acceso: solo lectura

TRUE si el disco se usa en un entorno agrupado o FALSE en caso contrario.

IsOffline

Tipo de datos: booleano

Tipo de acceso: solo lectura

TRUE si el disco está sin conexión o FALSE en caso contrario.

IsReadOnly

Tipo de datos: booleano

Tipo de acceso: solo lectura

TRUE si el disco es de solo lectura o FALSE si es de lectura y escritura.

IsSystem

Tipo de datos: booleano

Tipo de acceso: solo lectura

TRUE si este disco contiene la partición del sistema o FALSE en caso contrario.

LargestFreeExtent

Tipo de datos: UInt64

Tipo de acceso: solo lectura

Calificadores: unidades (bytes)

Bloque contiguo más grande de espacio libre en el disco. Este es también el tamaño más grande de una partición que se puede crear en el disco.

Ubicación

Tipo de datos: String

Tipo de acceso: solo lectura

Cadena que contiene la ruta de acceso de ubicación PnP del disco. El formato de esta cadena depende del tipo de bus. Si el tipo de bus es SCSI, SAS o PCI RAID, el formato es AdapterPnpLocationPath#BusType(PPathIdTTargetIdLLunId). Si el tipo de bus es IDE, ATA, PATA o SATA, el formato es AdapterPnpLocationPath#BusType(CPathIdTTargetIdLLunId). Consulte la sección Comentarios siguiente para ver una tabla que enumera las partes de esta cadena.

Nota:

En el caso de las imágenes de Hyper-V y VHD, esta propiedad es NULL, ya que el controlador virtual no devuelve la ruta de acceso de ubicación.

Para obtener más información sobre esta propiedad, vea la siguiente sección Comentarios.

LogicalSectorSize

Tipo de datos: UInt32

Tipo de acceso: solo lectura

Calificadores: unidades (bytes)

Tamaño del sector lógico del disco, en bytes. Por ejemplo, un disco nativo de 4K notificará 4096, mientras que un disco emulado 512 notificará 512.

Fabricante

Tipo de datos: String

Tipo de acceso: solo lectura

Representación de cadena del fabricante de hardware del disco.

Modelo

Tipo de datos: String

Tipo de acceso: solo lectura

Representación de cadena del número de modelo del disco.

Number

Tipo de datos: UInt32

Tipo de acceso: solo lectura

Número del sistema operativo para el disco. El disco 0 suele ser el dispositivo de arranque. Es posible que los números de disco no sigan siendo necesariamente los mismos en los reinicios.

NumberOfPartitions

Tipo de datos: UInt32

Tipo de acceso: solo lectura

Número de particiones que se han creado en el disco.

OfflineReason

Tipo de datos: UInt16

Tipo de acceso: solo lectura

Si IsOffline es TRUE, esta propiedad contiene el motivo de que el disco esté sin conexión.

Uno de los valores siguientes.

Valor	Significado
Directiva 1	El usuario solicitó que el disco esté sin conexión.
Ruta de acceso redundante 2	El disco se usa para E/S de varias rutas de acceso.
Instantánea 3	El disco es un disco de instantáneas.
Colisión 4	Hubo una colisión de firma o identificador con otro disco.
Agotamiento de recursos 5	No había recursos suficientes para poner el disco en línea.
Errores de escritura críticos 6	Hubo errores críticos de escritura en el disco.
Examen de integridad de datos requerido 7	Se requiere un examen de integridad de datos.

OperationalStatus

Tipo de datos: UInt16

Tipo de acceso: solo lectura

Estado operativo del dispositivo de disco.

Valor	Significado
Unknown 0	El estado operativo es desconocido.
Other 1	Se ha especificado un OperationalStatus específico del proveedor estableciendo la propiedad OtherOperationalStatusDescription.
OK 2	El disco responde a los comandos y está en un estado operativo normal.
Degraded 3	El disco responde a los comandos, pero no se ejecuta en un estado operativo óptimo.
Stressed 4	El disco funciona, pero necesita atención. Por ejemplo, el disco podría sobrecargarse o sobrecalentarse.
Predictive Failure 5	El disco funciona, pero es probable que se produzca un error en el futuro próximo.
Error 6	Se ha producido un error.
Non-Recoverable Error 7	Se ha producido un error no recuperable.
Starting 8	El disco está en proceso de inicio.
Stopping 9	El disco está en proceso de detención.
Stopped 10	El disco se detuvo o se cerró de forma limpia y ordenada.
In Service 11	El disco se está configurando, manteniendo, limpiando o administrando de otro modo.
No Contact 12	El proveedor de almacenamiento tiene conocimiento del disco, pero nunca ha podido establecer la comunicación con él.
Lost Communication 13	El proveedor de almacenamiento tiene conocimiento del disco y se ha puesto en contacto con él correctamente en el pasado, pero el disco no es accesible actualmente.
Aborted 14	De forma similar a Detenido, excepto que el disco se detuvo abruptamente y puede requerir configuración o mantenimiento.
Dormant 15	El disco es accesible, pero está inactivo.
Supporting Entity in Error 16	Este valor de estado no indica necesariamente problemas con el disco, pero indica que otro dispositivo o conexión de los que depende el disco puede necesitar atención.
Completed 17	El disco ha completado una operación. Este valor de estado debe combinarse con Ok, Error o Degradado, en función del resultado de la operación.
0xD010 en línea	En los subsistemas de almacenamiento basados en Windows, esto indica que el objeto está en línea.
No listo 0xD011	En los subsistemas de almacenamiento basados en Windows, esto indica que el objeto no está listo.
Sin 0xD012 multimedia	En los subsistemas de almacenamiento basados en Windows, esto indica que el objeto no tiene ningún medio presente.
0xD013 sin conexión	En los subsistemas de almacenamiento basados en Windows, esto indica que el objeto está sin conexión.
Error 0xD014	En los subsistemas de almacenamiento basados en Windows, esto indica que el objeto está en estado de error.

PartitionStyle

Tipo de datos: UInt16

Tipo de acceso: solo lectura

Calificadores: Required

Estilo de partición usado por el disco.

Valor	Significado
Unknown 0	El estilo de partición es desconocido.
MBR 1	Registro de arranque maestro (MBR)
GPT 2	Tabla de particiones GUID (GPT)

Path

Tipo de datos: String

Tipo de acceso: solo lectura

Calificadores: Required

Ruta de acceso que se puede usar para abrir un identificador de sistema operativo en el dispositivo de disco.

PhysicalSectorSize

Tipo de datos: UInt32

Tipo de acceso: solo lectura

Calificadores: unidades (bytes)

Tamaño del sector físico del disco, en bytes. Por ejemplo, los discos nativos 4K y 512 emulados notificarán 4096.

ProvisioningType

Tipo de datos: UInt16

Tipo de acceso: solo lectura

Tipo de aprovisionamiento del dispositivo de disco.

Valor	Significado
Unknown 0	El esquema de aprovisionamiento no está especificado.
Thin 1	El almacenamiento del disco se asigna a petición.
Fixed 2	El almacenamiento se asigna cuando se crea el disco.

SerialNumber

Tipo de datos: String

Tipo de acceso: solo lectura

Representación de cadena del número de serie del disco.

Signature

Tipo de datos: UInt32

Tipo de acceso: solo lectura

Si PartitionStyle es MBR, esta propiedad contiene la firma de partición MBR. Esta propiedad será NULL para todos los demás tipos de disco.

Tamaño

Tipo de datos: UInt64

Tipo de acceso: solo lectura

Calificadores: obligatorio, unidades (bytes)

Tamaño total del disco, en bytes.

UniqueId

Tipo de datos: String

Tipo de acceso: solo lectura

Identificador de disco. Contiene la página VPD 0x83 información que identifica de forma única este disco. Se aceptan los siguientes tipos (en orden de prioridad):

8 (cadena de nombre SCSI)
3 (nombre de FCPH)
2 (EUI64)
1 (Id. de proveedor)
0 (específico del proveedor)

Si el disco es un disco virtual expuesto, se usa UniqueId para asignar la asociación entre los dos objetos.

UniqueIdFormat

Tipo de datos: UInt16

Tipo de acceso: solo lectura

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

Formato del identificador de disco. Esta propiedad contiene el tipo de descriptor vpD Page 0x83 que se usó para establecer la propiedad UniqueId .

Comentarios

En la tabla siguiente se enumeran las partes de la cadena de ruta de acceso de ubicación usada en la propiedad Location .

Parte de ruta de acceso de ubicación	Descripción
AdapterPnpLocationPath	Ruta de acceso de ubicación de PnP del adaptador. Esto se recupera llamando a la función SetupDiGetDeviceProperty , pasando &DEVPKEY_Device_LocationPaths para el parámetro PropertyKey .
BusType	Tipo de bus: ATA, RAID, SAS o SCSI. Nota: Si el tipo de bus es IDE, PATA o SATA, aparece como ATA en la cadena de ruta de acceso de ubicación. Si es PCI RAID, aparece como RAID.
PathId	Número del autobús. Este es el valor del miembro PathId de la estructura SCSI_ADDRESS que devuelve el código de control IOCTL_SCSI_GET_ADDRESS .
TargetId	Número del dispositivo de destino. Este es el valor del miembro TargetId de la estructura SCSI_ADDRESS que devuelve el código de control IOCTL_SCSI_GET_ADDRESS .
LunId	Número del LUN. Este es el valor del miembro Lun de la estructura SCSI_ADDRESS que devuelve el código de control IOCTL_SCSI_GET_ADDRESS .

La tabla siguiente contiene ejemplos de rutas de acceso de ubicación.

Tipo de bus	Ruta de acceso de ubicación de ejemplo
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)

A partir de Windows 10: MSFT_Disk deriva de MSFT_StorageObject. Ahora hereda la propiedad ObjectId, que anteriormente era una propiedad de MSFT_Disk.

Requisitos

Requisito	Valor
Cliente mínimo compatible	Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2012 [solo aplicaciones de escritorio]
Espacio de nombres	Root\Microsoft\Windows\Storage
MOF	Storagewmi.mof

Compartir a través de

clase MSFT_Disk

Sintaxis

Miembros

Métodos

Propiedades

Comentarios

Requisitos

Comentarios

Recursos adicionales