struktur VDS_DISK_PROP (vds.h)

Artikel
03/08/2023

[Dimulai dengan Windows 8 dan Windows Server 2012, antarmuka COM Layanan Disk Virtual digantikan oleh API Manajemen Penyimpanan Windows.]

Menentukan properti objek disk.

Sintaks

typedef struct _VDS_DISK_PROP {
  VDS_OBJECT_ID        id;
  VDS_DISK_STATUS      status;
  VDS_LUN_RESERVE_MODE ReserveMode;
  VDS_HEALTH           health;
  DWORD                dwDeviceType;
  DWORD                dwMediaType;
  ULONGLONG            ullSize;
  ULONG                ulBytesPerSector;
  ULONG                ulSectorsPerTrack;
  ULONG                ulTracksPerCylinder;
  ULONG                ulFlags;
  VDS_STORAGE_BUS_TYPE BusType;
  VDS_PARTITION_STYLE  PartitionStyle;
  union {
    DWORD dwSignature;
    GUID  DiskGuid;
  };
  LPWSTR               pwszDiskAddress;
  LPWSTR               pwszName;
  LPWSTR               pwszFriendlyName;
  LPWSTR               pwszAdaptorName;
  LPWSTR               pwszDevicePath;
} VDS_DISK_PROP, *PVDS_DISK_PROP;

Anggota

id

GUID objek disk.

status

Ketersediaan disk fisik yang dijumlahkan oleh VDS_DISK_STATUS. Jika layanan VDS tidak dapat membuka handel ke disk, layanan akan mengatur anggota ini ke VDS_DS_UNKNOWN.

Catatan Anggota ini dapat VDS_DS_ONLINE, bahkan jika status paket yang berisi VDS_PS_OFFLINE.

ReserveMode

Anggota ini dicadangkan untuk digunakan di masa mendatang.

health

Nilai enumerasi VDS_HEALTH yang menentukan status kesehatan disk. Berikut ini adalah nilai yang valid untuk anggota ini.

VDS_H_UNKNOWN (0)

VDS_H_HEALTHY (1)

VDS_H_FAILING (4)

VDS_H_FAILED (8)

dwDeviceType

Jenis perangkat yang ditentukan dalam Winioctl.h, yang mencakup jenis berikut antara lain:

dwMediaType

Jenis media yang dijumlahkan oleh STORAGE_MEDIA_TYPE. Peta disk dasar dan dinamis ke enumerator FixedMedia . Untuk informasi selengkapnya, lihat STORAGE_MEDIA_TYPE.

ullSize

Ukuran disk dalam byte. Untuk menentukan ukuran volume maksimum untuk disk, panggil IVdsDisk3::QueryFreeExtents dan tambahkan ukuran semua tingkat gratis.

ulBytesPerSector

Jumlah byte di setiap sektor.

ulSectorsPerTrack

Jumlah sektor di setiap trek.

ulTracksPerCylinder

Jumlah trek di setiap silinder.

ulFlags

Bitmask dari nilai enumerasi VDS_DISK_FLAG yang menentukan berbagai atribut disk.

BusType

Jenis bus input/output yang dijumlahkan oleh VDS_STORAGE_BUS_TYPE.

PartitionStyle

Nilai enumerasi VDS_PARTITION_STYLE yang menentukan jenis partisi. Anggota ini adalah diskriminan untuk serikat.

dwSignature

Digunakan jika PartitionStyleVDS_PST_MBR (1). Tanda tangan untuk partisi MBR. Nilai ini tidak dijamin unik.

DiskGuid

Digunakan jika PartitionStyleVDS_PST_GPT (2). GUID untuk disk. Selain itu, setiap partisi GPT memiliki GUID sendiri. (Lihat VDS_PARTITION_INFO_GPT.)

pwszDiskAddress

Alamat disk seperti SCSI dalam formatNNN Target NNNJalurNNNTargetNNN, di manaNNN adalah satu atau beberapa digit.

Disk SCSI, disk IDE, dan disk Fibre Channel dapat memiliki alamat tersebut. Disk USB dan 1394 memiliki format alamat yang berbeda dan tidak disimpan.

Anggota ini bersifat opsional dan dapat berupa NULL jika tidak ada nilai yang tersedia. Jika bukan NULL, panjangnya harus lebih besar dari atau sama dengan 22 WCHAR dan kurang dari atau sama dengan 64 WCHAR, termasuk terminator NULL yang diperlukan. Aplikasi yang menerima struktur VDS_DISK_PROP dengan memanggil IVdsDisk::GetProperties harus memeriksa apakah anggota ini NULL.

pwszName

Nama yang digunakan untuk membuka handel ke objek yang dibuat menggunakan fungsi CreateFile . Misalnya: \\?\PhysicalDrive2

pwszFriendlyName

Nama yang dikembalikan oleh Manajer Plug and Play. Nama ini dipertahankan di registri Windows oleh Plug and Play Manager, misalnya: "Seagate ST34573N SCSI Disk Device".

pwszAdaptorName

Nama adaptor tempat disk ini terpasang. Manajer Plug and Play mengembalikan nama, yang dipertahankan di registri Windows, misalnya: "Adaptec AHA-2940U2W - Ultra2 SCSI".

pwszDevicePath

String yang dikembalikan oleh Plug and Play Manager. Manajer Plug and Play menggunakan jalur perangkat untuk mengidentifikasi perangkat secara unik di komputer. Untuk informasi selengkapnya, lihat SP_DEVICE_INTERFACE_DETAIL_DATA_W.

Keterangan

Metode IVdsDisk::GetProperties mengembalikan nilai struktur ini untuk melaporkan properti objek disk.

Persyaratan


Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	vds.h