struktur VDS_POOL_ATTRIBUTES (vdshwprv.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 atribut kumpulan penyimpanan.

Sintaks

typedef struct _VDS_POOL_ATTRIBUTES {
  ULONGLONG                  ullAttributeMask;
  VDS_RAID_TYPE              raidType;
  VDS_STORAGE_BUS_TYPE       busType;
  LPWSTR                     pwszIntendedUsage;
  BOOL                       bSpinDown;
  BOOL                       bIsThinProvisioned;
  ULONGLONG                  ullProvisionedSpace;
  BOOL                       bNoSinglePointOfFailure;
  ULONG                      ulDataRedundancyMax;
  ULONG                      ulDataRedundancyMin;
  ULONG                      ulDataRedundancyDefault;
  ULONG                      ulPackageRedundancyMax;
  ULONG                      ulPackageRedundancyMin;
  ULONG                      ulPackageRedundancyDefault;
  ULONG                      ulStripeSize;
  ULONG                      ulStripeSizeMax;
  ULONG                      ulStripeSizeMin;
  ULONG                      ulDefaultStripeSize;
  ULONG                      ulNumberOfColumns;
  ULONG                      ulNumberOfColumnsMax;
  ULONG                      ulNumberOfColumnsMin;
  ULONG                      ulDefaultNumberofColumns;
  ULONG                      ulDataAvailabilityHint;
  ULONG                      ulAccessRandomnessHint;
  ULONG                      ulAccessDirectionHint;
  ULONG                      ulAccessSizeHint;
  ULONG                      ulAccessLatencyHint;
  ULONG                      ulAccessBandwidthWeightHint;
  ULONG                      ulStorageCostHint;
  ULONG                      ulStorageEfficiencyHint;
  ULONG                      ulNumOfCustomAttributes;
  VDS_POOL_CUSTOM_ATTRIBUTES *pPoolCustomAttributes;
  BOOL                       bReserved1;
  BOOL                       bReserved2;
  ULONG                      ulReserved1;
  ULONG                      ulReserved2;
  ULONGLONG                  ullReserved1;
  ULONGLONG                  ullReserved2;
} VDS_POOL_ATTRIBUTES, *PVDS_POOL_ATTRIBUTES;

Anggota

ullAttributeMask

Masker yang menentukan atribut dalam struktur yang ditentukan oleh kumpulan penyimpanan ini.

Daftar bendera atribut yang valid adalah sebagai berikut. Setiap bendera sesuai dengan anggota dalam struktur VDS_POOL_ATTRIBUTES . Bit yang tidak digunakan dicadangkan.

Nilai	Atribut yang ditentukan oleh kumpulan penyimpanan
VDS_POOL_ATTRIB_RAIDTYPE 0x1L	raidType
VDS_POOL_ATTRIB_BUSTYPE 0x2L	busType
VDS_POOL_ATTRIB_ALLOW_SPINDOWN 0x4L	bSpinDown
VDS_POOL_ATTRIB_THIN_PROVISION 0x8L	bIsThinProvisioned
VDS_POOL_ATTRIB_NO_SINGLE_POF 0x10L	bNoSinglePointOfFailure
VDS_POOL_ATTRIB_DATA_RDNCY_MAX 0x20L	ulDataRedundancyMax
VDS_POOL_ATTRIB_DATA_RDNCY_MIN 0x40L	ulDataRedundancyMin
VDS_POOL_ATTRIB_DATA_RDNCY_DEF 0x80L	ulDataRedundancyDefault
VDS_POOL_ATTRIB_PKG_RDNCY_MAX 0x100L	ulPackageRedundancyDefault
VDS_POOL_ATTRIB_PKG_RDNCY_MIN 0x200L	ulPackageRedundancyMin
VDS_POOL_ATTRIB_PKG_RDNCY_DEF 0x400L	ulPackageRedundancyDefault
VDS_POOL_ATTRIB_STRIPE_SIZE 0x800L	ulStripeSize
VDS_POOL_ATTRIB_STRIPE_SIZE_MAX 0x1000L	ulStripeSizeMax
VDS_POOL_ATTRIB_STRIPE_SIZE_MIN 0x2000L	ulStripeSizeMin
VDS_POOL_ATTRIB_STRIPE_SIZE_DEF 0x4000L	ulDefaultStripeSize
VDS_POOL_ATTRIB_NUM_CLMNS 0x8000L	ulNumberOfColumns
VDS_POOL_ATTRIB_NUM_CLMNS_MAX 0x10000L	ulNumberOfColumnsMax
VDS_POOL_ATTRIB_NUM_CLMNS_MIN 0x20000L	ulNumberOfColumnsMin
VDS_POOL_ATTRIB_NUM_CLMNS_DEF 0x40000L	ulDefaultNumberofColumns
VDS_POOL_ATTRIB_DATA_AVL_HINT 0x80000L	ulDataAvailabilityHint
VDS_POOL_ATTRIB_ACCS_RNDM_HINT 0x100000L	ulAccessRandomnessHint
VDS_POOL_ATTRIB_ACCS_DIR_HINT 0x200000L	ulAccessDirectionHint
VDS_POOL_ATTRIB_ACCS_SIZE_HINT 0x400000L	ulAccessSizeHint
VDS_POOL_ATTRIB_ACCS_LTNCY_HINT 0x800000L	ulAccessLatencyHint
VDS_POOL_ATTRIB_ACCS_BDW_WT_HINT 0x1000000L	ulAccessBandwidthWeightHint
VDS_POOL_ATTRIB_STOR_COST_HINT 0x2000000L	ulStorageCostHint
VDS_POOL_ATTRIB_STOR_EFFCY_HINT 0x4000000L	ulStorageEfficiencyHint
VDS_POOL_ATTRIB_CUSTOM_ATTRIB 0x8000000L	pPoolCustomAttributes

raidType

Nilai enumerasi VDS_RAID_TYPE yang menentukan jenis RAID kumpulan penyimpanan. Jika kumpulan penyimpanan tidak memiliki jenis RAID tertentu, atur anggota ini ke VDS_RT_UNKNOWN dan hapus bendera atribut VDS_POOL_ATTRIB_RAIDTYPE di anggota ullAttributeMask .

busType

Nilai enumerasi VDS_STORAGE_BUS_TYPE yang menentukan jenis bus drive di kumpulan penyimpanan.

pwszIntendedUsage

String yang menentukan penggunaan kumpulan penyimpanan. Biasanya, ini dapat menunjukkan aplikasi yang menggunakan kumpulan penyimpanan (misalnya, "SQL" atau "Exchange") atau fungsi bisnis yang menggunakan kumpulan penyimpanan (misalnya, "Keuangan" atau "Sumber Daya Manusia").

bSpinDown

TRUE jika drive di kumpulan penyimpanan berputar secara otomatis untuk mengurangi penggunaan daya, atau FALSE sebaliknya.

bIsThinProvisioned

TRUE jika kumpulan penyimpanan diprovisikan tipis, atau FALSE jika tidak. Jika kumpulan diprovisikan tipis, jumlah byte dalam ruang kumpulan yang dikonsumsi bisa kurang dari jumlah byte di ruang kumpulan yang disediakan. (Jumlah byte dalam ruang yang disediakan disimpan di anggota ullProvisionedSpace dari struktur ini. Jumlah byte dalam ruang yang digunakan disimpan di anggota ullTotalConsumedSpace dari struktur VDS_STORAGE_POOL_PROP .) Ketika penyedia perangkat keras mengatur anggota ini ke TRUE, penyedia perangkat keras juga harus mengatur anggota jenis struktur VDS_STORAGE_POOL_PROP ke VDS_SPT_CONCRETE.

ullProvisionedSpace

Jika kumpulan disediakan tipis, anggota ini menentukan ruang, dalam byte, yang disediakan untuk kumpulan. Nilai anggota ini harus lebih besar dari atau sama dengan nilai anggota ullTotalConsumedSpace dari struktur VDS_STORAGE_POOL_PROP .

bNoSinglePointOfFailure

TRUE jika tidak ada satu titik kegagalan di kumpulan, atau FALSE sebaliknya.

ulDataRedundancyMax

Jumlah maksimum salinan lengkap data yang dapat dipertahankan di kumpulan penyimpanan ini.

ulDataRedundancyMin

Jumlah minimum salinan lengkap data yang dapat dipertahankan di kumpulan penyimpanan ini.

ulDataRedundancyDefault

Jumlah default salinan lengkap data yang dipertahankan di kumpulan penyimpanan ini.

ulPackageRedundancyMax

Jumlah maksimum drive yang dapat digunakan di kumpulan penyimpanan untuk memastikan redundansi paket. Redundansi paket menunjukkan jumlah drive yang dapat gagal di kumpulan penyimpanan tanpa mengakibatkan kehilangan data.

ulPackageRedundancyMin

Jumlah minimum drive yang dapat digunakan di kumpulan penyimpanan untuk memastikan redundansi paket. Redundansi paket menunjukkan jumlah drive yang dapat gagal di kumpulan penyimpanan tanpa mengakibatkan kehilangan data.

ulPackageRedundancyDefault

Jumlah default drive yang digunakan di kumpulan penyimpanan untuk memastikan redundansi paket. Redundansi paket menunjukkan jumlah drive yang dapat gagal di kumpulan penyimpanan tanpa mengakibatkan kehilangan data.

ulStripeSize

Ukuran garis cermin atau paritas, dalam byte, dari kumpulan penyimpanan jika kumpulan bergaris (dengan atau tanpa paritas).

ulStripeSizeMax

Ukuran garis maksimum, dalam byte, yang didukung oleh kumpulan penyimpanan.

ulStripeSizeMin

Ukuran garis minimum, dalam byte, yang didukung oleh kumpulan penyimpanan.

ulDefaultStripeSize

Ukuran garis default, dalam byte, yang didukung oleh kumpulan penyimpanan.

ulNumberOfColumns

Jumlah kolom kumpulan penyimpanan jika kumpulan bergaris (dengan atau tanpa paritas).

ulNumberOfColumnsMax

Jumlah maksimum kolom yang didukung oleh kumpulan penyimpanan.

ulNumberOfColumnsMin

Jumlah minimum kolom yang didukung oleh kumpulan penyimpanan.

ulDefaultNumberofColumns

Jumlah default kolom yang didukung oleh kumpulan penyimpanan.

ulDataAvailabilityHint

Petunjuk dari klien yang menunjukkan pentingnya ditempatkan pada ketersediaan data. Nilai berkisar dari 0 (Tidak Penting) hingga 10 (Sangat Penting).

ulAccessRandomnessHint

Petunjuk dari klien yang menunjukkan keacakan akses data. Nilai berkisar dari 0 (Seluruhnya Berurutan) hingga 10 (Sepenuhnya Acak).

ulAccessDirectionHint

Petunjuk dari klien yang menunjukkan arah akses data. Nilai berkisar dari 0 (Seluruhnya Dibaca) hingga 10 (Seluruhnya Tulis).

ulAccessSizeHint

Petunjuk dari klien yang menunjukkan ukuran akses optimal dalam megabyte.

ulAccessLatencyHint

Petunjuk dari klien yang menunjukkan pentingnya latensi akses ke klien. Nilai berkisar dari 0 (Tidak Penting) hingga 10 (Sangat Penting).

ulAccessBandwidthWeightHint

Petunjuk dari klien yang menunjukkan pentingnya bandwidth tinggi. Nilai berkisar dari 0 (Tidak Penting) hingga 10 (Sangat Penting).

ulStorageCostHint

Petunjuk dari klien yang menunjukkan pentingnya biaya penyimpanan kepada klien. Nilai berkisar dari 0 (Tidak Penting) hingga 10 (Sangat Penting). Jika biaya penyimpanan sangat penting bagi klien, nilai 10 menunjukkan bahwa klien akan lebih memilih untuk menyediakan kumpulan menggunakan penyimpanan biaya yang lebih rendah.

ulStorageEfficiencyHint

Petunjuk dari klien yang menunjukkan pentingnya efisiensi penyimpanan kepada klien. Nilai berkisar dari 0 (Tidak Penting) hingga 10 (Sangat Penting).

ulNumOfCustomAttributes

Jumlah atribut kustom yang ditentukan untuk kumpulan penyimpanan.

pPoolCustomAttributes

Array struktur VDS_POOL_CUSTOM_ATTRIBUTES . Setiap struktur berisi atribut kustom yang ditentukan untuk kumpulan penyimpanan.

bReserved1