MSFT_PhysicalDisk class

  • 7 minutes to read

Represents a subsystem drive or spindle.

The following syntax is simplified from Managed Object Format (MOF) code.

Syntax

class MSFT_PhysicalDisk : MSFT_StorageFaultDomain
{
  UInt16  UniqueIdFormat;
  String  DeviceId;
  String  FriendlyName;
  UInt16  HealthStatus;
  UInt16  OperationalStatus[];
  String  OperationalDetails[];
  String  PhysicalLocation;
  UInt16  VirtualDiskFootprint;
  UInt16  Usage;
  UInt16  SupportedUsages[];
  String  Description;
  String  PartNumber;
  String  FirmwareVersion;
  String  SoftwareVersion;
  UInt64  Size;
  UInt64  AllocatedSize;
  UInt16  BusType;
  Boolean IsWriteCacheEnabled;
  Boolean IsPowerProtected;
  UInt64  PhysicalSectorSize;
  UInt64  LogicalSectorSize;
  UInt32  SpindleSpeed;
  Boolean IsIndicationEnabled;
  UInt16  EnclosureNumber;
  UInt16  SlotNumber;
  Boolean CanPool;
  UInt16  CannotPoolReason[];
  String  OtherCannotPoolReasonDescription;
  Boolean IsPartial;
  UInt16  MediaType;
};

Members

The MSFT_PhysicalDisk class has these types of members:

Methods

The MSFT_PhysicalDisk class has these methods.

Method Description
Maintenance Allows maintenance operations to be performed on the physical disk while in a concrete pool, such as firmware updates.
Reset Resets the physical disk.
SetAttributes Updates the attributes of the physical disk.
SetDescription Sets or changes the description for the physical disk.
SetFriendlyName Sets or changes the friendly name for the physical disk.
SetUsage Sets or changes the intended usage for the physical disk within a concrete pool.
SetWriteCache Allows the physical disk's write cache to be enabled or disabled.

Properties

The MSFT_PhysicalDisk class has these properties.

AllocatedSize

Data type: UInt64

Access type: Read-only

Qualifiers: Units ("Bytes")

The total amount of used space on this physical disk. This should include usage from all storage pools and other data stored on the disk.

BusType

Data type: UInt16

Access type: Read-only

Qualifiers: Required

The storage bus type of the physical disk.

Value Meaning
Unknown
0
 The bus type is unknown.
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
 Multimedia Card (MMC)
MAX
14
 This value is reserved for system use.
File Backed Virtual
15
 File-Backed Virtual
Storage Spaces
16
 Storage Spaces
NVMe
17
Microsoft Reserved
18..
 This value is reserved for system use.

CannotPoolReason

Data type: UInt16 array

Access type: Read-only

Qualifiers: Required

An array of values specifying the reasons why this physical disk cannot be added to a concrete pool. This property is valid only if the CanPool property is FALSE.

Unknown (0)

Other (1)

In a Pool (2)

Not Healthy (3)

Removable Media (4)

In Use by Cluster (5)

Offline (6)

Insufficient Capacity (7)

Spare Disk (8)

Reserved by subsystem (9)

Starting (10)

Microsoft Reserved (..)

Vendor Reserved (0x8000..)

CanPool

Data type: Boolean

Access type: Read-only

Qualifiers: Required

TRUE if this physical disk can be added to a concrete pool.

Description

Data type: String

Access type: Read-only

A user-settable description of the physical disk.

DeviceId

Data type: String

Access type: Read-only

An address or other identifier that uniquely names the physical disk.

EnclosureNumber

Data type: UInt16

Access type: Read-only

The number of the enclosure in which the disk physically resides.

FirmwareVersion

Data type: String

Access type: Read-only

Qualifiers: Required

A string representation of the firmware revision.

FriendlyName

Data type: String

Access type: Read-only

Qualifiers: Required

A user-friendly display name for the physical disk. The initial value should be set by the storage provider or subsystem, and can be modified by the user at any point in the object's lifetime.

HealthStatus

Data type: UInt16

Access type: Read-only

A high-level indication of device health.

Value Meaning
0
 Healthy
1
 Warning
2
 Unhealthy
5
 Unknown

IsIndicationEnabled

Data type: Boolean

Access type: Read-only

Indicates whether the physical disk's identification LEDs are active or not. This is typically used in maintenance operations.

IsPartial

Data type: Boolean

Access type: Read-only

TRUE if this physical disk is partially consumed by a system or service outside of normal storage pool operations.

IsPowerProtected

Data type: Boolean

Access type: Read-only

Indicates whether this physical disk is equipped to tolerate a power loss without loss of data.

IsWriteCacheEnabled

Data type: Boolean

Access type: Read-only

Indicates whether write caching is enabled on this physical disk or not.

LogicalSectorSize

Data type: UInt64

Access type: Read-only

Qualifiers: Required, Units ("Bytes")

The logical sector size of the physical disk, in bytes. For example: a 4K native disk should report 4096, while a 512-byte emulated disk should report 512.

MediaType

Data type: UInt16

Access type: Read-only

The media type of the physical disk.

Value Meaning
0
 Unspecified
3
 HDD
4
 SSD
5
 SCM

OperationalDetails

Data type: String array

Access type: Read-only

An array of strings providing further information on a given operational status.

OperationalStatus

Data type: UInt16 array

Access type: Read-only

An array of operational status values further explaining a given health status.

OtherCannotPoolReasonDescription

Data type: String

Access type: Read-only

A string containing the vendor-defined reason why this physical disk cannot be added to a concrete pool. This property must be NULL if the value of the CannotPoolReason property is not Other.

PartNumber

Data type: String

Access type: Read-only

Qualifiers: Required

A string representation of the physical disk's part number or SKU.

PhysicalLocation

Data type: String

Access type: Read-only

This field is a free-form string indicating where the hardware is located.

PhysicalSectorSize

Data type: UInt64

Access type: Read-only

Qualifiers: Required, Units ("Bytes")

The physical sector size of the physical disk, in bytes. For example: for 4K native and 512-byte emulated disks, the value of this property should be 4096.

Size

Data type: UInt64

Access type: Read-only

Qualifiers: Units ("Bytes")

Total physical storage size of the disk, in bytes.

SlotNumber

Data type: UInt16

Access type: Read-only

The number of the enclosure slot in which the disk physically resides.

SoftwareVersion

Data type: String

Access type: Read-only

Qualifiers: Required

A string representation of the software version number.

SpindleSpeed

Data type: UInt32

Access type: Read-only

Qualifiers: Required, Units ("RPM")

The rotational speed of spindle-based physical disks. For solid state devices (SSDs) or other non-rotational media, this member should be set to 0. For rotating media that has an unknown speed, this member should be set to 0xFFFFFFFF (UINT32_MAX).

SupportedUsages

Data type: UInt16 array

Access type: Read-only

Qualifiers: Required

An array of values that specify the supported usages for this physical disk.

Value Meaning
Unknown
0
 The intended usage is not specified.
Auto-Select
1
 This physical disk should only be used for data storage.
Manual-Select
2
 This physical disk should only be used if manually selected by an administrator at the time of virtual disk creation. A manual-select disk is selected using the PhysicalDisksToUse parameter to CreateVirtualDisk.
Hot Spare
3
 This physical disk should be used as a hot spare.
Retired
4
 This physical disk should be retired from use. At a minimum, no new allocations should go to this disk. If the virtual disks that reside on this disk are repaired, the data should be moved to another active physical disk.
Journal
5
 This physical disk should be used as a cache for other devices comprising a virtual disk. It will back a virtual disk s write-back cache, if configured.

UniqueIdFormat

Data type: UInt16

Access type: Read-only

Qualifiers: Required

Indicates the type of identifier used in the UniqueId field (inherited from MSFT_StorageObject). The identifier used in UniqueId must be the highest available identifier using the following order of preference: 8 (highest), 3, 2, 1, 0 (lowest). For example, if the physical disk device exposes identifiers of type 0, 1, and 3, UniqueId must be the identifier of type 3, and UniqueIdFormat should be set to 3.

Vendor Specific (0)

Vendor Id (1)

EUI64 (2)

FCPH Name (3)

SCSI Name String (8)

Usage

Data type: UInt16

Access type: Read-only

Qualifiers: Required

The intended usage of this physical disk within a concrete pool.

Storage pools are required to follow the assigned policy for a physical disk.

Value Meaning
Unknown
0
 The intended usage is not specified.
Auto-Select
1
 This physical disk should only be used for data storage.
Manual-Select
2
 This physical disk should only be used if manually selected by an administrator at the time of virtual disk creation. A manual-select disk is selected using the PhysicalDisksToUse parameter to CreateVirtualDisk.
Hot Spare
3
 This physical disk should be used as a hot spare.
Retired
4
 This physical disk should be retired from use. At a minimum, no new allocations should go to this disk. If the virtual disks that reside on this disk are repaired, the data should be moved to another active physical disk.
Journal
5
 This physical disk should be used as a cache for other devices comprising a virtual disk. It will back a virtual disk s write-back cache, if configured.

VirtualDiskFootprint

Data type: UInt16

Access type: Read-only

This field indicates the size in bytes of the user data footprint from virtual disks on this physical disk.

Requirements
Minimum supported client
 Windows 8 [desktop apps only]
Minimum supported server
 Windows Server 2012 [desktop apps only]
Namespace
 Root\Microsoft\Windows\Storage
MOF
Storagewmi.mof