kelas MSFT_Disk

Artikel
03/08/2023

Mewakili disk Windows.

Objek MSFT_Disk memodelkan konsep sistem operasi Windows dari perangkat disk. Disk dapat langsung dilampirkan ke sistem komputer, atau mungkin disk virtual yang terekspos ke sistem melalui penggunaan Penyedia Manajemen Penyimpanan.

Sintaks berikut disederhanakan dari kode Managed Object Format (MOF).

Sintaks

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

Anggota

Kelas MSFT_Disk memiliki jenis anggota ini:

Metode
Properti

Metode

Kelas MSFT_Disk memiliki metode ini.

Metode	Deskripsi
Bersihkan	Menghapus informasi partisi dan tidak menginisialisasi disk, mengembalikannya ke status RAW.
ConvertStyle	Mengonversi gaya partisi dari disk yang sudah diinisialisasi.
CreatePartition	Membuat partisi pada disk.
Menginisialisasi	Menginisialisasi disk RAW dengan gaya partisi tertentu.
Luring	Membuat disk offline.
Online	Membawa disk online.
Refresh	Menyegarkan informasi tata letak disk yang di-cache.
SetAttributes	Mengatur atribut dan properti disk.

Properti

Kelas MSFT_Disk memiliki properti ini.

Alokasi Ukuran

Jenis data: UInt64

Jenis akses: Baca-saja

Kualifikasi: Wajib, Unit (Byte)

Jumlah ruang, dalam byte, yang saat ini digunakan pada disk.

BootFromDisk

Jenis data: Boolean

Jenis akses: Baca-saja

TRUE jika komputer dikonfigurasi untuk memulai dari disk ini. Pada komputer dengan firmware BIOS, ini adalah disk pertama yang dideteksi firmware selama startup. Pada komputer yang menggunakan firmware EFI, ini adalah disk yang berisi Partisi Sistem EFI (ESP). Jika tidak ada disk, atau jika ada beberapa disk dengan partisi ESP, properti ini tidak diatur untuk disk apa pun.

BusType

Jenis data: UInt16

Jenis akses: Baca-saja

Jenis bus I/O yang digunakan oleh disk.

Nilai	Makna
Tidak diketahui 0	Jenis bus tidak diketahui.
SCSI 1	SCSI
ATAPI 2	ATAPI
ATA 3	ATA
1394 4	IEEE 1394
SSA 5	SSA
Saluran Serat 6	Saluran Serat
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	Kartu Multimedia (MMC)
Virtual 14	Nilai ini dicadangkan untuk penggunaan sistem.
File Didukung Virtual 15	Virtual yang Didukung File
Ruang Penyimpanan 16	Ruang penyimpanan
NVMe 17	NVMe

FirmwareVersion

Jenis data: String

Jenis akses: Baca-saja

Representasi string dari versi firmware disk.

FriendlyName

Jenis data: String

Jenis akses: Baca-saja

Kualifikasi: Diperlukan

String yang mudah digunakan dan berorientasi tampilan untuk mengidentifikasi disk.

Guid

Jenis data: String

Jenis akses: Baca-saja

Jika PartitionStyle adalah GPT, properti ini berisi GUID untuk disk. Properti ini akan menjadi NULL untuk semua tipe disk lainnya.

HealthStatus

Jenis data: UInt16

Jenis akses: Baca-saja

Status kesehatan perangkat disk.

Nilai	Makna
Sehat 0	Disk berfungsi secara normal.
Peringatan 1	Disk masih berfungsi, tetapi telah mendeteksi kesalahan atau masalah yang memerlukan intervensi administrator.
Tidak Sehat 2	Volume tidak berfungsi, karena kesalahan atau kegagalan. Volume membutuhkan perhatian segera dari administrator.

IsBoot

Jenis data: Boolean

Jenis akses: Baca-saja

TRUE jika disk berisi partisi boot.

IsClustered

Jenis data: Boolean

Jenis akses: Baca-saja

TRUE jika disk digunakan di lingkungan berkluster, atau FALSE sebaliknya.

IsOffline

Jenis data: Boolean

Jenis akses: Baca-saja

TRUE jika disk offline, atau FALSE sebaliknya.

IsReadOnly

Jenis data: Boolean

Jenis akses: Baca-saja

TRUE jika disk bersifat baca-saja, atau FALSE jika dibaca/ditulis.

IsSystem

Jenis data: Boolean

Jenis akses: Baca-saja

TRUE jika disk ini berisi partisi sistem, atau FALSE sebaliknya.

TerbesarFreeExtent

Jenis data: UInt64

Jenis akses: Baca-saja

Kualifikasi: Unit (Byte)

Blok ruang kosong terbesar yang bersebelahan pada disk. Ini juga merupakan ukuran terbesar partisi yang dapat dibuat pada disk.

Location

Jenis data: String

Jenis akses: Baca-saja

String yang berisi jalur lokasi PnP disk. Format string ini tergantung pada jenis bus. Jika jenis bus adalah SCSI, SAS, atau PCI RAID, formatnya adalah AdapterPnpLocationPath#BusType(PPathIdTTargetIdLLunId). Jika jenis bus adalah IDE, ATA, PATA, atau SATA, formatnya adalah AdapterPnpLocationPath#BusType(CPathIdTTargetIdLLunId). Lihat bagian Keterangan berikut untuk tabel yang mencantumkan bagian string ini.

Catatan

Untuk gambar Hyper-V dan VHD, properti ini adalah NULL, karena pengontrol virtual tidak mengembalikan jalur lokasi.

Untuk informasi selengkapnya tentang properti ini, lihat bagian Komentar berikut ini.

LogicalSectorSize

Jenis data: UInt32

Jenis akses: Baca-saja

Kualifikasi: Unit (Byte)

Ukuran sektor logis disk, dalam byte. Misalnya, disk asli 4K akan melaporkan 4096, sementara disk 512 yang ditiru akan melaporkan 512.

Produsen

Jenis data: String

Jenis akses: Baca-saja

Representasi string dari produsen perangkat keras disk.

Model

Jenis data: String

Jenis akses: Baca-saja

Representasi string dari nomor model disk.

Number

Jenis data: UInt32

Jenis akses: Baca-saja

Nomor sistem operasi untuk disk. Disk 0 biasanya merupakan perangkat boot. Nomor disk mungkin belum tentu tetap sama di seluruh mulai ulang.

NumberOfPartitions

Jenis data: UInt32

Jenis akses: Baca-saja

Jumlah partisi yang telah dibuat pada disk.

OfflineReason

Jenis data: UInt16

Jenis akses: Baca-saja

Jika IsOffline TRUE, properti ini berisi alasan disk offline.

Salah satu nilai berikut.

Nilai	Makna
Kebijakan 1	Pengguna meminta disk offline.
Jalur Redundan 2	Disk digunakan untuk I/O multi-jalur.
Rekam jepret 3	Disk adalah disk rekam jepret.
Tabrakan 4	Ada tanda tangan atau tabrakan pengidentifikasi dengan disk lain.
Kelelahan Sumber Daya 5	Ada sumber daya yang tidak cukup untuk membuat disk online.
Kegagalan Penulisan Kritis 6	Ada kegagalan penulisan kritis pada disk.
Pemindaian Integritas Data Diperlukan 7	Pemindaian integritas data diperlukan.

OperationalStatus

Jenis data: UInt16

Jenis akses: Baca-saja

Status operasional perangkat disk.

Nilai	Makna
Tidak diketahui 0	Status operasional tidak diketahui.
1 Lainnya	OperationalStatus khusus vendor telah ditentukan dengan mengatur properti OtherOperationalStatusDescription.
OK 2	Disk merespons perintah dan berada dalam status operasi normal.
Terdegradasi 3	Disk merespons perintah, tetapi tidak berjalan dalam status operasi yang optimal.
Stres 4	Disk berfungsi, tetapi perlu perhatian. Misalnya, disk mungkin kelebihan beban atau terlalu panas.
Kegagalan Prediktif 5	Disk berfungsi, tetapi kegagalan kemungkinan akan terjadi dalam waktu dekat.
Kesalahan 6	Terjadi kesalahan.
Kesalahan Tidak Dapat Dipulihkan 7	Terjadi kesalahan yang tidak dapat dipulihkan.
Mulai 8	Disk sedang dalam proses memulai.
Menghentikan 9	Disk sedang dalam proses penghentian.
Dihentikan 10	Disk dihentikan atau dimatikan dengan cara yang bersih dan teratur.
Di Layanan 11	Disk sedang dikonfigurasi, dikelola, dibersihkan, atau dikelola.
Tidak Ada Kontak 12	Penyedia penyimpanan memiliki pengetahuan tentang disk, tetapi belum pernah dapat menjalin komunikasi dengannya.
Komunikasi Hilang 13	Penyedia penyimpanan memiliki pengetahuan tentang disk dan telah berhasil menghubunginya di masa lalu, tetapi disk saat ini tidak dapat dijangkau.
Dibatalkan 14	Mirip dengan Dihentikan, kecuali disk berhenti tiba-tiba dan mungkin memerlukan konfigurasi atau pemeliharaan.
Tidak aktif 15	Disk dapat dijangkau, tetapi tidak aktif.
Entitas Pendukung dalam Kesalahan 16	Nilai status ini tidak selalu menunjukkan masalah dengan disk, tetapi menunjukkan bahwa perangkat atau koneksi lain yang bergantung pada disk mungkin perlu diperhatikan.
Selesai 17	Disk telah menyelesaikan operasi. Nilai status ini harus dikombinasikan dengan OK, Error, atau Degraded, tergantung pada hasil operasi.
0xD010 online	Di subsistem penyimpanan berbasis Windows, ini menunjukkan bahwa objek sedang online.
Tidak Siap 0xD011	Di subsistem penyimpanan berbasis Windows, ini menunjukkan bahwa objek belum siap.
Tidak ada 0xD012 Media	Di subsistem penyimpanan berbasis Windows, ini menunjukkan bahwa objek tidak memiliki media yang ada.
0xD013 offline	Di subsistem penyimpanan berbasis Windows, ini menunjukkan bahwa objek sedang offline.
Gagal 0xD014	Dalam subsistem penyimpanan berbasis Windows, ini menunjukkan bahwa objek dalam keadaan gagal.

PartitionStyle

Jenis data: UInt16

Jenis akses: Baca-saja

Kualifikasi: Diperlukan

Gaya partisi yang digunakan oleh disk.

Nilai	Makna
Tidak diketahui 0	Gaya partisi tidak diketahui.
MBR 1	Catatan Boot Master (MBR)
GPT 2	Guid Partition Table (GPT)

Jalur

Jenis data: String

Jenis akses: Baca-saja

Kualifikasi: Diperlukan

Jalur yang dapat digunakan untuk membuka handel sistem operasi ke perangkat disk.

PhysicalSectorSize

Jenis data: UInt32

Jenis akses: Baca-saja

Kualifikasi: Unit (Byte)

Ukuran sektor fisik disk, dalam byte. Misalnya, disk asli 4K dan disk yang ditiru 512 akan melaporkan 4096.

ProvisioningType

Jenis data: UInt16

Jenis akses: Baca-saja

Jenis provisi perangkat disk.

Nilai	Makna
Tidak diketahui 0	Skema provisi tidak ditentukan.
Tipis 1	Penyimpanan untuk disk dialokasikan sesuai permintaan.
Tetap 2	Penyimpanan dialokasikan saat disk dibuat.

SerialNumber

Jenis data: String

Jenis akses: Baca-saja

Representasi string dari nomor seri disk.

Tanda tangan

Jenis data: UInt32

Jenis akses: Baca-saja

Jika PartitionStyle adalah MBR, properti ini berisi tanda tangan partisi MBR. Properti ini akan menjadi NULL untuk semua tipe disk lainnya.

Ukuran

Jenis data: UInt64

Jenis akses: Baca-saja

Kualifikasi: Wajib, Unit (Byte)

Ukuran total disk, dalam byte.

UniqueId

Jenis data: String

Jenis akses: Baca-saja

Pengidentifikasi disk. Ini berisi halaman VPD 0x83 informasi yang secara unik mengidentifikasi disk ini. Jenis berikut diterima (dalam urutan prioritas):

8 (String Nama SCSI)
3 (Nama FCPH)
2 (EUI64)
1 (Id Vendor)
0 (Khusus Vendor)

Jika disk adalah disk virtual yang diekspos, UniqueId digunakan untuk memetakan hubungan antara dua objek.

UniqueIdFormat

Jenis data: UInt16

Jenis akses: Baca-saja

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

Format pengidentifikasi disk. Properti ini berisi halaman VPD 0x83 jenis deskriptor yang digunakan untuk mengatur properti UniqueId .

Keterangan

Tabel berikut mencantumkan bagian string jalur lokasi yang digunakan dalam properti Lokasi .

Bagian jalur lokasi	Deskripsi
AdapterPnpLocationPath	Jalur lokasi PnP adaptor. Ini diambil dengan memanggil fungsi SetupDiGetDeviceProperty , meneruskan &DEVPKEY_Device_LocationPaths untuk parameter PropertyKey .
BusType	Jenis bus: ATA, RAID, SAS, atau SCSI. Catatan: Jika jenis bus adalah IDE, PATA, atau SATA, jenis bus muncul sebagai ATA di string jalur lokasi. Jika PCI RAID, itu muncul sebagai RAID.
PathId	Jumlah bus. Ini adalah nilai anggota PathId dari struktur SCSI_ADDRESS yang dikembalikan oleh kode kontrol IOCTL_SCSI_GET_ADDRESS .
TargetId	Jumlah perangkat target. Ini adalah nilai anggota TargetId dari struktur SCSI_ADDRESS yang dikembalikan oleh kode kontrol IOCTL_SCSI_GET_ADDRESS .
LunId	Jumlah LUN. Ini adalah nilai anggota Lun dari struktur SCSI_ADDRESS yang dikembalikan oleh kode kontrol IOCTL_SCSI_GET_ADDRESS .

Tabel berikut berisi contoh jalur lokasi.

Jenis bus	Contoh jalur lokasi
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)

Mulai dari Windows 10: MSFT_Disk berasal dari MSFT_StorageObject. Sekarang mewarisi properti ObjectId, yang sebelumnya merupakan properti MSFT_Disk.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Ruang nama	Root\Microsoft\Windows\Storage
MOF	Storagewmi.mof

Bagikan melalui

kelas MSFT_Disk

Sintaks

Anggota

Metode

Properti

Keterangan

Persyaratan

Saran dan Komentar

Sumber Daya Tambahan: