struktur VDS_VOLUME_PROP2 (vds.h)

Artikel
03/08/2023

[Dimulai dengan Windows 8 dan Windows Server 2012, antarmuka COM Layanan Disk Virtual digantikan oleh WINDOWS Storage Management API.]

Menentukan properti objek volume. Struktur ini identik dengan struktur VDS_VOLUME_PROP , kecuali bahwa struktur ini juga menyertakan GUID volume.

Sintaks

typedef struct _VDS_VOLUME_PROP2 {
  VDS_OBJECT_ID        id;
  VDS_VOLUME_TYPE      type;
  VDS_VOLUME_STATUS    status;
  VDS_HEALTH           health;
  VDS_TRANSITION_STATE TransitionState;
  ULONGLONG            ullSize;
  ULONG                ulFlags;
  VDS_FILE_SYSTEM_TYPE RecommendedFileSystemType;
  ULONG                cbUniqueId;
  LPWSTR               pwszName;
  BYTE                 *pUniqueId;
} VDS_VOLUME_PROP2, *PVDS_VOLUME_PROP2;

Anggota

id

GUID volume.

type

Nilai enumerasi VDS_VOLUME_TYPE yang menentukan jenis volume. Jenis volume sederhana, membentang, bergaris (RAID-0), dicerminkan, atau bergaris dengan paritas (RAID-5).

status

Nilai enumerasi VDS_VOLUME_STATUS yang menentukan status volume.

health

Nilai enumerasi VDS_HEALTH yang menentukan status kesehatan volume.

TransitionState

Nilai enumerasi VDS_TRANSITION_STATE yang menentukan status transisi volume.

ullSize

Ukuran volume, dalam byte.

ulFlags

Bitmask nilai enumerasi VDS_VOLUME_FLAG yang menjelaskan volume.

RecommendedFileSystemType

Nilai enumerasi VDS_FILE_SYSTEM_TYPE yang menentukan sistem file pilihan untuk volume. Harus salah satu hal berikut: VDS_FST_NTFS, VDS_FST_FAT, VDS_FST_FAT32, VDS_FST_UDF, VDS_FST_CDFS, atau VDS_FST_UNKNOWN.

cbUniqueId

Panjang array byte yang dituju anggota pUniqueId .

pwszName

Nama yang digunakan untuk membuka handel untuk volume dengan fungsi CreateFile . Misalnya, \?\GLOBALROOT\Device\HarddiskVolume1.

pUniqueId

Array byte yang berisi pengidentifikasi unik untuk volume.

Keterangan

Metode IVdsVolume2::GetProperties2 mengembalikan struktur ini untuk melaporkan properti objek volume.

Ketika volume offline, bendera VDS_VF_PERMANENTLY_DISMOUNTED diatur di anggota ulFlags dari struktur VDS_VOLUME_PROP2 , dan nilai status volume VDS_VS_OFFLINE juga diatur dalam anggota status struktur ini.

Untuk volume GPT dan dinamis, pengidentifikasi unik yang dituju anggota pUniqueId unik secara global.

Untuk drive media yang dapat dilepas, volume ada dan memiliki pengidentifikasi uniknya sendiri meskipun tidak ada media di perangkat. Jika volume diformat pada media yang dapat dilepas, volume tersebut memiliki pengidentifikasi uniknya sendiri. Untuk informasi selengkapnya, lihat Mendukung Permintaan Mount Manager di Driver Kelas Penyimpanan.

Format pengidentifikasi unik dapat bervariasi di antara berbagai jenis perangkat dan volume. Untuk volume dasar pada disk MBR, pengidentifikasi unik didasarkan pada tanda tangan disk dan offset partisi. Karena tanda tangan disk dan offset partisi adalah nilai DWORD, pengidentifikasi unik tidak dapat dijamin unik secara global di seluruh komputer.

Jika tanda tangan disk berubah, pengidentifikasi unik volume juga berubah. Perubahan tanda tangan disk biasanya terjadi sebagai akibat dari tabrakan selama kloning disk.

Perhatikan bahwa pengidentifikasi unik tidak sama dengan jalur GUID volume. Untuk menemukan jalur GUID volume untuk volume, gunakan metode IVdsVolumeMF3::QueryVolumeGuidPathnames .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Header	vds.h