struktur VDS_DISK_PROP (vds.h)
[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.
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 |