struktur VDS_STORAGE_POOL_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 kumpulan penyimpanan.

Sintaks

typedef struct _VDS_STORAGE_POOL_PROP {
  VDS_OBJECT_ID           id;
  VDS_STORAGE_POOL_STATUS status;
  VDS_HEALTH              health;
  VDS_STORAGE_POOL_TYPE   type;
  LPWSTR                  pwszName;
  LPWSTR                  pwszDescription;
  ULONGLONG               ullTotalConsumedSpace;
  ULONGLONG               ullTotalManagedSpace;
  ULONGLONG               ullRemainingFreeSpace;
} VDS_STORAGE_POOL_PROP, *PVDS_STORAGE_POOL_PROP;

Anggota

id

Nilai VDS_OBJECT_ID yang mengidentifikasi objek kumpulan penyimpanan.

status

Nilai enumerasi VDS_STORAGE_POOL_STATUS yang menentukan status kumpulan penyimpanan.

health

Nilai enumerasi VDS_HEALTH yang menentukan kesehatan kumpulan penyimpanan. Berikut ini adalah nilai yang valid untuk anggota ini.

Windows Server 2008, Windows Vista, dan Windows Server 2003: VDS_H_DEGRADED tidak didukung.

VDS_H_UNKNOWN (0)

VDS_H_HEALTHY (1)

VDS_H_DEGRADED (11)

type

Nilai enumerasi VDS_STORAGE_POOL_TYPE yang menentukan jenis kumpulan penyimpanan.

pwszName

String yang menentukan nama kumpulan penyimpanan.

pwszDescription

String yang berisi deskripsi kumpulan penyimpanan.

ullTotalConsumedSpace

Jumlah penyimpanan fisik yang mendukung kumpulan penyimpanan, dalam byte. Nilai anggota ini harus kurang dari atau sama dengan nilai anggota ullProvisionedSpace dari struktur VDS_POOL_ATTRIBUTES .

ullTotalManagedSpace

Ruang, dalam byte, di kumpulan penyimpanan ini yang dapat dialokasikan untuk membuat elemen penyimpanan anak (LUN atau kumpulan), termasuk ruang yang telah dialokasikan. Bergantung pada cara kumpulan penyimpanan dikonfigurasi, nilai anggota ini bisa jauh lebih kecil dari nilai anggota ullTotalConsumedSpace . Misalnya, jika kumpulan penyimpanan dikonfigurasi sebagai kumpulan cermin, nilai ullTotalManagedSpace hanya setengah sebesar nilai anggota ullTotalConsumedSpace .

ullRemainingFreeSpace

Ukuran maksimum yang dapat digunakan untuk membuat LUN baru atau kumpulan penyimpanan anak dari kumpulan ini, atau untuk memperluas LUN atau kumpulan penyimpanan anak yang ada. Untuk menghitung jumlah ruang terkelola yang telah dialokasikan ke LUN atau kumpulan penyimpanan anak yang ada, kurangi nilai anggota ini dari nilai anggota ullTotalManagedSpace .

Keterangan

IVdsStoragePool::GetProperties mengembalikan struktur ini untuk melaporkan properti objek kumpulan penyimpanan.

Contoh berikut menunjukkan bagaimana anggota ullTotalConsumedSpace, ullTotalManagedSpace, dan ullRemainingFreeSpace bekerja sama.

Contoh 1

Misalkan Anda memiliki 2 drive masing-masing 1 TB. Misalkan lebih lanjut bahwa Anda melakukan hal berikut:
  1. Buat kumpulan penyimpanan sebagai kumpulan cermin.
  2. Buat LUN yang ukurannya 200 GB.

ullTotalConsumedSpace = 2 TB. Ini adalah jumlah ruang kumpulan penyimpanan yang didukung oleh penyimpanan fisik atau disk fisik. Membuat LUN dari kumpulan tidak mengubah nomor ini.

ullTotalManagedSpace = 1 TB. Ini adalah ukuran maksimum LUN atau kumpulan penyimpanan yang dapat dibuat dari kumpulan ini. Hanya 1 TB yang tersedia, karena jenis kumpulan adalah cermin hanya dengan 2 pleks.

Catatan Jika jenis kumpulan adalah RAID5, ullTotalManagedSpace akan menjadi (N-1)/N * ullTotalConsumedSpace, di mana N adalah jumlah kolom. Misalnya, dengan 5 drive dan 5 kolom, ullTotalManagedSpace adalah (5-1)/5 * ullTotalConsumedSpace atau 1,6 TB.

 

ullRemainingFreeSpace = 800 GB (1 TB – 200 GB), karena 200GB telah dialokasikan ke LUN.

(ullTotalManagedSpace - ullRemainingFreeSpace) adalah jumlah ruang terkelola yang dialokasikan untuk LUN dan kumpulan yang dibuat dari kumpulan ini. Dalam contoh ini, ullTotalManagedSpace - ullRemainingFreeSpace = 200 GB.

Contoh 2

Misalkan Anda memiliki 2 drive masing-masing 1 TB. Misalkan lebih lanjut bahwa Anda melakukan hal berikut:
  1. Buat kumpulan penyimpanan sebagai kumpulan cermin.
  2. Buat LUN yang disediakan tipis yang ukurannya 10 TB.

ullProvisionedSpace = 10 TB. Ini hanya berlaku untuk kumpulan yang disediakan tipis. Ini adalah total ruang yang disediakan untuk kumpulan. Total ruang yang dikonsumsi oleh kumpulan kurang dari atau sama dengan total ruang yang disediakan untuk kumpulan.

ullTotalConsumedSpace = 2 TB.

ullTotalManagedSpace = 1 TB.

ullRemainingFreeSpace = 1 TB dikurangi jumlah ruang terkelola yang saat ini mendukung LUN.

Catatan Meskipun ukuran LUN adalah 10 TB, mungkin ada sedikitnya 10 GB ruang terkelola yang mendukung LUN, dalam hal ini akan ada 20 GB ruang yang dikonsumsi yang mendukung LUN yang dicerminkan.

 

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

Lihat juga

IVdsStoragePool::GetProperties