struktur VDS_HINTS (vds.h)

[Dimulai dengan Windows 8 dan Windows Server 2012, antarmuka COM Layanan Disk Virtual digantikan oleh API Manajemen Penyimpanan Windows.]

Menentukan petunjuk automagic 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.

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 mencadangkan 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

Ukuran interleave garis cermin atau paritas, dalam byte. Nol membuat 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 dibaca (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 anggota bOptimizeForSequentialReads dan bOptimizeForSequentialWrites keduanya ke FALSE mengoptimalkan untuk I/O acak. Atur bendera VDS_HINT_OPTIMIZEFORSEQUENTIALREADS di anggota ullHintMask untuk menunjukkan minat pada anggota ini.

bOptimizeForSequentialWrites

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

bRemapEnabled

Jika anggota ini TRUE, penyedia memetakan kembali jangkauan LUN untuk mendorong jangkauan secara otomatis. Jika FALSE, pemetaan LUN sejauh mana ekstensi drive tetap diperbaiki setelah konfigurasi LUN kecuali sejauh mana 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 TRUE, drive yang berkontribusi pada LUN dapat dihapus secara fisik tanpa gangguan yang signifikan pada sistem (ini biasanya benar ketika LUN terdiri dari hanya beberapa drive). Jika FALSE, LUN tidak dapat dihapus tanpa gangguan 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, masing-masing. 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 arahan untuk pelaksana. Meskipun pelaksana secara umum diharapkan untuk melakukan yang terbaik untuk mempertimbangkan petunjuk, mereka tidak berkewajiban untuk mengikutinya. Pelaksana dapat memilih alternatif ketika tidak dapat mengikuti petunjuk tertentu karena alasan teknis atau ketika mengikutinya dapat mengakibatkan konfigurasi yang buruk.

Persyaratan

Lihat juga

IVdsLun::ApplyHints

IVdsLun::QueryHints

IVdsLunPlex::ApplyHints

IVdsLunPlex::QueryHints

IVdsSubSystem::CreateLun

Struktur VDS