MSFT_Disk クラス

Windows ディスクを表します。

MSFT_Disk オブジェクトは Windows オペレーティング システムのディスク デバイスの概念を手本にします。 ディスクは、コンピューター システムに直接接続、またはストレージ管理プロバイダーを使用してシステムに公開される仮想ディスクである可能性があります。

次の構文は、Managed Object Format (MOF) コードをシンプルにしたものです。

構文

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

メンバー

MSFT_Disk クラスには、次の種類のメンバーがあります。

• メソッド
• プロパティ

メソッド

MSFT_Disk クラスには、次のメソッドがあります。

プロパティ

MSFT_Disk クラスには、次のプロパティがあります。

AllocatedSize

データ型: UInt64

アクセスの種類: 読み取り専用

修飾子: 必須、単位 (Bytes)

現在ディスクで使用されているスペースの量 (バイト単位)。

BootFromDisk

データ型: Boolean

アクセスの種類: 読み取り専用

コンピューターがこのディスクから起動するように構成されている場合は TRUE です。 BIOS のファームウェアを搭載したコンピューターでは、これはファームウェアが起動中に検出する最初のディスクです。 EFI ファームウェアを搭載したコンピューターでは、これは EFI システム パーティション (ESP) を含むディスクです。 ディスクがない場合、または ESP パーティションを使用する複数のディスクがある場合、このプロパティはどのディスクにも設定されません。

BusType

データ型: UInt16

アクセスの種類: 読み取り専用

ディスクが使用する I/O バスの種類。

FirmwareVersion

データ型: 文字列

アクセスの種類: 読み取り専用

ディスクのファームウェア バージョンの文字列表現。

FriendlyName

データ型: 文字列

アクセスの種類: 読み取り専用

修飾子: 必須

ディスクを識別するための、わかりやすい表示指向の文字列。

GUID

データ型: 文字列

アクセスの種類: 読み取り専用

PartitionStyle が GPT である場合、このプロパティにはディスクの GUID が含まれます。 他のすべての種類のディスクでは、このプロパティは NULL になります。

HealthStatus

データ型: UInt16

アクセスの種類: 読み取り専用

ディスク デバイスの正常性状態。

IsBoot

データ型: Boolean

アクセスの種類: 読み取り専用

ディスクにブート パーティションが含まれている場合は TRUE です。

IsClustered

データ型: Boolean

アクセスの種類: 読み取り専用

クラスター環境でディスクが使用されている場合は TRUE、それ以外の場合は FALSE です。

IsOffline

データ型: Boolean

アクセスの種類: 読み取り専用

ディスクがオフラインの場合は TRUE、それ以外の場合は FALSE です。

IsReadOnly

データ型: Boolean

アクセスの種類: 読み取り専用

ディスクが読み取り専用の場合は TRUE、読み取り/書き込みである場合は FALSE です。

IsSystem

データ型: Boolean

アクセスの種類: 読み取り専用

このディスクにシステム パーティションが含まれている場合は TRUE、それ以外の場合は FALSE です。

LargestFreeExtent

データ型: UInt64

アクセスの種類: 読み取り専用

修飾子: 単位 (バイト)

ディスク上の空き容量の最大連続ブロック。 これは、ディスクに作成できるパーティションの最大サイズでもあります。

場所

データ型: String

アクセスの種類: 読み取り専用

ディスクの PnP ロケーション パスを含む文字列。 この文字列の書式は、バスの種類によって異なります。 バスの種類が SCSI、SAS、または PCI RAID の場合、書式は AdapterPnpLocationPath#BusType(PPathIdTTargetIdLLunId) です。 バスの種類が IDE、ATA、PATA または SATA の場合、書式は AdapterPnpLocationPath#BusType(CPathIdTTargetIdLLunId) です。 この文字列の一部を一覧表示するテーブルについては、次の「解説」セクションを参照してください。

このプロパティの詳細については、以下の「解説」を参照してください。

LogicalSectorSize

データ型: UInt32

アクセスの種類: 読み取り専用

修飾子: 単位 (バイト)

ディスクの論理セクター サイズ (バイト単位)。 たとえば、4K ネイティブ ディスクは 4096 を報告し、512 エミュレート ディスクは 512 を報告します。

メーカー

データ型: 文字列

アクセスの種類: 読み取り専用

ディスク ハードウェア製造元の文字列表現。

モデル

データ型: 文字列

アクセスの種類: 読み取り専用

ディスクのモデル番号の文字列表現。

番号

データ型: UInt32

アクセスの種類: 読み取り専用

ディスクのオペレーティング システム番号。 通常、ディスク 0 はブート デバイスです。 ディスク番号は、再起動すると必ずしも同じままであるとは限りません。

NumberOfPartitions

データ型: UInt32

アクセスの種類: 読み取り専用

ディスク上に作成されたパーティション数。

OfflineReason

データ型: UInt16

アクセスの種類: 読み取り専用

IsOffline が TRUE の場合、このプロパティにはディスクがオフラインになっている理由が含まれます。

次のいずれかの値です。

OperationalStatus

データ型: UInt16

アクセスの種類: 読み取り専用

ディスク デバイスの操作状態です。

PartitionStyle

データ型: UInt16

アクセスの種類: 読み取り専用

修飾子: 必須

ディスクが使用するパーティション スタイルです。

Path

データ型: String

アクセスの種類: 読み取り専用

修飾子: 必須

ディスク デバイスへのオペレーティング システム ハンドルを開くために使用できるパス。

PhysicalSectorSize

データ型: UInt32

アクセスの種類: 読み取り専用

修飾子: 単位 (バイト)

ディスクの物理セクター サイズ (バイト単位)。 たとえば、4K ネイティブ ディスクと 512 エミュレート ディスクの両方共 4096 を報告します。

ProvisioningType

データ型: UInt16

アクセスの種類: 読み取り専用

ディスク デバイスのプロビジョニングの種類。

SerialNumber

データ型: 文字列

アクセスの種類: 読み取り専用

ディスクのシリアル番号の文字列表現。

Signature

データ型: UInt32

アクセスの種類: 読み取り専用

PartitionStyle が MBR の場合、このプロパティには MBR パーティション署名が含まれます。 他のすべての種類のディスクでは、このプロパティは NULL になります。

[サイズ]

データ型: UInt64

アクセスの種類: 読み取り専用

修飾子: 必須、単位 (Bytes)

ディスクの合計サイズ (バイト単位)。

UniqueId

データ型: String

アクセスの種類: 読み取り専用

ディスク識別子です。 これには、このディスクを一意に識別する VPD ページ 0x83 情報が含まれます。 次の型が受け入れられます (優先順位順)。

• 8 (SCSI 名文字列)
• 3 (FCPH 名)
• 2 (EUI64)
• 1 (ベンダー Id)
• 0 (ベンダー固有)

ディスクが公開済みの仮想ディスクである場合、2 つのオブジェクト間の関連付けをマッピングするために UniqueId が使用されます。

UniqueIdFormat

データ型: UInt16

アクセスの種類: 読み取り専用

修飾子: 値 ("ベンダー固有"、"ベンダー Id"、"EUI64"、"FCPH 名"、"SCSI 名文字列")、ValueMap ("0"、"1"、"2"、"3"、"8")

ディスク識別子の形式。 このプロパティには、UniqueId プロパティを設定するために使用した、VPD ページ 0x83 記述子が含まれます。

解説

次のテーブルには、Location プロバイダーで使用するロケーション パス文字列の一部が列記されています。

次のテーブルに、ロケーション パスの例を示します。

Windows 10: MSFT_Disk 以降では、 MSFT_StorageObjectから派生します。 以前は MSFT_Disk のプロパティであった ObjectId プロパティを継承するようになりました。

要件