struktur VDS_HINTS (vdshwprv.h)

  • Artikel

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

Menentukan petunjuk otomatis untuk pleks LUN atau LUN.

Sintaks

typedef struct _VDS_HINTS {
  ULONGLONG ullHintMask;
  ULONGLONG ullExpectedMaximumSize;
  ULONG     ulOptimalReadSize;
  ULONG     ulOptimalReadAlignment;
  ULONG     ulOptimalWriteSize;
  ULONG     ulOptimalWriteAlignment;
  ULONG     ulMaximumDriveCount;
  ULONG     ulStripeSize;
  BOOL      bFastCrashRecoveryRequired;
  BOOL      bMostlyReads;
  BOOL      bOptimizeForSequentialReads;
  BOOL      bOptimizeForSequentialWrites;
  BOOL      bRemapEnabled;
  BOOL      bReadBackVerifyEnabled;
  BOOL      bWriteThroughCachingEnabled;
  BOOL      bHardwareChecksumEnabled;
  BOOL      bIsYankable;
  SHORT     sRebuildPriority;
} VDS_HINTS, *PVDS_HINTS;

Anggota

ullHintMask

Masker petunjuk LUN. Masing-masing anggota BOOL struktur ini memiliki bendera petunjuk yang sesuai yang dapat diatur dalam masker. Jika bendera petunjuk diatur, petunjuk yang sesuai akan dipertimbangkan. Jika bendera petunjuk tidak diatur, petunjuk akan diabaikan. Bendera petunjuk dijelaskan dalam tabel berikut.

Nilai Makna
VDS_HINT_FASTCRASHRECOVERYREQUIRED
0x0000000000000001L
 Penyedia membatasi waktu yang diperlukan untuk pemulihan. Untuk mendukung pemulihan cepat, penyedia menggunakan log perubahan yang memungkinkan penyedia memulihkan LUN tanpa membandingkan seluruh konten LUN.
VDS_HINT_MOSTLYREADS
0x0000000000000002L
 Penyedia mengoptimalkan LUN untuk pola penggunaan baca-sebagian besar, biasanya dengan menggunakan pencerminan daripada striping paritas.
VDS_HINT_OPTIMIZEFORSEQUENTIALREADS
0x0000000000000004L
 Penyedia mengoptimalkan LUN untuk pola penggunaan baca berurutan. Jika bendera ini tidak diatur dan VDS_HINT_OPTIMIZEFORSEQUENTIALWRITES juga tidak diatur, LUN dioptimalkan untuk I/O acak.
VDS_HINT_OPTIMIZEFORSEQUENTIALWRITES
0x0000000000000008L
 Penyedia mengoptimalkan LUN untuk pola penggunaan tulis berurutan. Jika bendera ini tidak diatur dan VDS_HINT_OPTIMIZEFORSEQUENTIALREADS juga tidak diatur, LUN dioptimalkan untuk I/O acak.
VDS_HINT_READBACKVERIFYENABLED
0x0000000000000010L
 Penyedia memverifikasi penulisan ke LUN dengan menggunakan readback.
VDS_HINT_REMAPENABLED
0x0000000000000020L
 Pemetaan LUN sejauh jangkauan drive dibuat dan diperbarui secara otomatis oleh penyedia. Jika bendera ini tidak diatur, pemetaan tetap diperbaiki setelah konfigurasi, kecuali ketika tindakan proaktif diambil untuk menghindari kegagalan drive.
VDS_HINT_WRITETHROUGHCACHINGENABLED
0x0000000000000040L
 Penyedia mengaktifkan kebijakan penembolokan write-through pada LUN.
VDS_HINT_HARDWARECHECKSUMENABLED
0x0000000000000080L
 Penyedia mengaktifkan checksum perangkat keras pada LUN.
VDS_HINT_ISYANKABLE
0x0000000000000100L
 Penyedia mengonfigurasi LUN sehingga drive yang berkontribusi padanya dapat dihapus secara fisik dengan gangguan sistem minimal. Ini biasanya dicapai dengan memastikan bahwa LUN menempati drive sesekali.

ullExpectedMaximumSize

Ukuran maksimum di mana LUN diperkirakan akan tumbuh, dalam byte. Nilai dapat sama dengan, lebih besar dari, atau kurang dari nilai yang ditentukan dalam ullSizeInBytes ketika metode IVdsSubSystem::CreateLun dipanggil. Beberapa penyedia menggunakan nilai ini untuk memesan ruang untuk LUN. Penyedia yang tidak dapat mencadangkan ruang biasanya mengabaikan parameter ini.

ulOptimalReadSize

Ukuran baca optimal untuk LUN, dalam byte. Nol menunjukkan tidak ada ukuran baca yang optimal.

ulOptimalReadAlignment

Penyelarasan baca optimal sehubungan dengan blok logis pertama LUN. Nol menunjukkan tidak ada perataan baca yang optimal.

ulOptimalWriteSize

Ukuran tulis optimal untuk LUN, dalam byte. Nol menunjukkan tidak ada ukuran tulis yang optimal.

ulOptimalWriteAlignment

Keselarasan tulis optimal sehubungan dengan blok logis pertama LUN. Nol menunjukkan tidak ada perataan tulis yang optimal.

ulMaximumDriveCount

Jumlah maksimum drive untuk berkontribusi pada LUN. Nol menunjukkan tidak ada jumlah drive maksimum. Nilai ini dapat digunakan untuk membatasi jumlah interleave stripe dalam set stripe.

ulStripeSize

Cermin atau garis paritas berukuran interleave, dalam byte. Nol meninggalkan ukuran garis tidak ditentukan.

bFastCrashRecoveryRequired

Jika anggota ini TRUE, waktu pemulihan terbatas. Atur bendera VDS_HINT_FASTCRASHRECOVERYREQUIRED di anggota ullHintMask untuk menunjukkan minat pada anggota ini.

bMostlyReads

Untuk mengoptimalkan pola penggunaan yang sebagian besar membaca (misalnya, melalui pencerminan daripada striping paritas), atur anggota ini ke TRUE. Jika tidak, atur ke FALSE. Atur bendera VDS_HINT_MOSTLYREADS di anggota ullHintMask untuk menunjukkan minat pada anggota ini.

bOptimizeForSequentialReads

Untuk mengoptimalkan pola penggunaan baca berurutan, atur anggota ini ke TRUE. Jika tidak, atur ke FALSE. Mengatur bOptimizeForSequentialReads dan bOptimizeForSequentialWrites anggota keduanya ke FALSE mengoptimalkan I/O acak. Atur bendera VDS_HINT_OPTIMIZEFORSEQUENTIALREADS di anggota ullHintMask untuk menunjukkan minat pada anggota ini.

bOptimizeForSequentialWrites

Untuk mengoptimalkan pola penggunaan berurutan-tulis, atur ke anggota ini ke TRUE. Jika tidak, atur ke FALSE. Mengatur bOptimizeForSequentialReads dan bOptimizeForSequentialWrites anggota keduanya ke FALSE mengoptimalkan I/O acak. Atur bendera VDS_HINT_OPTIMIZEFORSEQUENTIALWRITES di anggota ullHintMask untuk menunjukkan minat pada anggota ini.

bRemapEnabled

Jika anggota ini TRUE, penyedia memetakan ulang LUN hingga tingkat drive secara otomatis. Jika FALSE, pemetaan LUN sejauh untuk mendorong tetap diperbaiki setelah konfigurasi LUN kecuali sejauh ini secara eksplisit dipetakan ulang untuk menghindari blok yang rusak. Atur bendera VDS_HINT_REMAPENABLED di anggota ullHintMask untuk menunjukkan minat pada anggota ini.

bReadBackVerifyEnabled

Jika anggota ini diatur ke TRUE, penyedia memverifikasi penulisan ke LUN dengan readback. Jika diatur ke FALSE, penyedia tidak memverifikasi penulisan. Atur bendera VDS_HINT_READBACKVERIFYENABLED di anggota ullHintMask untuk menunjukkan minat pada anggota ini.

bWriteThroughCachingEnabled

Jika anggota ini TRUE, penyedia mengaktifkan penembolokan write-through pada LUN. Jika FALSE, penyedia tidak mengaktifkan penembolokan write-through. Atur bendera VDS_HINT_WRITETHROUGHCACHINGENABLED di anggota ullHintMask untuk menunjukkan minat pada anggota ini.

bHardwareChecksumEnabled

Jika anggota ini TRUE, penyedia mengaktifkan checksum pada LUN. Atur bendera VDS_HINT_HARDWARECHECKSUMENABLED di anggota ullHintMask untuk menunjukkan minat pada anggota ini.

bIsYankable

Jika anggota ini BENAR, drive yang berkontribusi pada LUN dapat dihapus secara fisik tanpa gangguan signifikan pada sistem (ini biasanya benar ketika LUN terdiri dari hanya beberapa drive). Jika FALSE, LUN tidak dapat dihapus tanpa gangguan yang signifikan pada sistem. Atur bendera VDS_HINT_ISYANKABLE di anggota ullHintMask untuk menunjukkan minat pada anggota ini.

sRebuildPriority

Prioritas pembangunan kembali untuk LUN. Nilai dapat berkisar dari 0 (prioritas terendah) hingga 15 (prioritas tertinggi).

Keterangan

Metode IVdsSubSystem::CreateLun meneruskan struktur ini sebagai parameter untuk memberikan petunjuk untuk membuat LUN. Ini diteruskan sebagai parameter dalam metode ApplyHints pada antarmuka IVdsLun dan IVdsLunPlex untuk menerapkan serangkaian petunjuk baru ke pleks LUN atau LUN. Selanjutnya, ini dikembalikan oleh metode QueryHints pada antarmuka IVdsLun dan IVdsLunPlex untuk melaporkan petunjuk yang saat ini diterapkan ke pleks LUN atau LUN.

Petunjuk bukan direktif untuk pelaksana. Sementara pelaksana secara umum diharapkan untuk melakukan yang terbaik untuk mempertimbangkan petunjuk, mereka tidak diwajibkan untuk mengikuti mereka. Pelaksana dapat memilih alternatif ketika tidak dapat mengikuti petunjuk tertentu karena alasan teknis atau ketika mengikutinya dapat mengakibatkan konfigurasi yang buruk.

Persyaratan

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

Lihat juga

IVdsLun::ApplyHints

IVdsLun::QueryHints

IVdsLunPlex::ApplyHints

IVdsLunPlex::QueryHints

IVdsSubSystem::CreateLun

Struktur VDS