struktur VDS_HINTS2 (vds.h)

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

Berisi petunjuk automagic untuk LUN di kumpulan penyimpanan.

Sintaks

typedef struct _VDS_HINTS2 {
  ULONGLONG            ullHintMask;
  ULONGLONG            ullExpectedMaximumSize;
  ULONG                ulOptimalReadSize;
  ULONG                ulOptimalReadAlignment;
  ULONG                ulOptimalWriteSize;
  ULONG                ulOptimalWriteAlignment;
  ULONG                ulMaximumDriveCount;
  ULONG                ulStripeSize;
  ULONG                ulReserved1;
  ULONG                ulReserved2;
  ULONG                ulReserved3;
  BOOL                 bFastCrashRecoveryRequired;
  BOOL                 bMostlyReads;
  BOOL                 bOptimizeForSequentialReads;
  BOOL                 bOptimizeForSequentialWrites;
  BOOL                 bRemapEnabled;
  BOOL                 bReadBackVerifyEnabled;
  BOOL                 bWriteThroughCachingEnabled;
  BOOL                 bHardwareChecksumEnabled;
  BOOL                 bIsYankable;
  BOOL                 bAllocateHotSpare;
  BOOL                 bUseMirroredCache;
  BOOL                 bReadCachingEnabled;
  BOOL                 bWriteCachingEnabled;
  BOOL                 bMediaScanEnabled;
  BOOL                 bConsistencyCheckEnabled;
  VDS_STORAGE_BUS_TYPE BusType;
  BOOL                 bReserved1;
  BOOL                 bReserved2;
  BOOL                 bReserved3;
  SHORT                sRebuildPriority;
} VDS_HINTS2, *PVDS_HINTS2;

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 parameter ullSizeInBytes ketika metode IVdsHwProviderStoragePools::CreateLunInStoragePool 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.

ulReserved1

Anggota ini dicadangkan untuk digunakan di masa mendatang. Jangan gunakan.

ulReserved2

Anggota ini dicadangkan untuk digunakan di masa mendatang. Jangan gunakan.

ulReserved3

Anggota ini dicadangkan untuk digunakan di masa mendatang. Jangan gunakan.

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 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 TRUE, penyedia memverifikasi penulisan ke LUN dengan readback. Jika 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.

bAllocateHotSpare

TRUE jika klien ingin mengalokasikan hot spare drive untuk LUN ini, atau FALSE sebaliknya. Atur bendera VDS_HINT_ALLOCATEHOTSPARE di anggota ullHintMask untuk menunjukkan minat pada anggota ini.

bUseMirroredCache

TRUE jika klien ingin LUN ini menggunakan cache cermin, atau FALSE sebaliknya. Atur bendera VDS_HINT_USEMIRROREDCACHE di anggota ullHintMask untuk menunjukkan minat pada anggota ini.

bReadCachingEnabled

TRUE jika klien ingin LUN menggunakan penembolokan baca, atau FALSE sebaliknya. Atur bendera VDS_HINT_READCACHINGENABLED di anggota ullHintMask untuk menunjukkan minat pada anggota ini.

bWriteCachingEnabled

TRUE jika klien ingin LUN menggunakan penembolokan tulis, atau FALSE sebaliknya. Atur bendera VDS_HINT_WRITECACHINGENABLED di anggota ullHintMask untuk menunjukkan minat pada anggota ini.

bMediaScanEnabled

TRUE jika klien ingin mengaktifkan pemindaian media untuk LUN ini, atau FALSE jika tidak. Atur bendera VDS_HINT_MEDIASCANENABLED di anggota ullHintMask untuk menunjukkan minat pada anggota ini.

bConsistencyCheckEnabled

TRUE jika klien ingin mengaktifkan pemeriksaan konsistensi untuk LUN ini, atau FALSE jika tidak. Atur bendera VDS_HINT_CONSISTENCYCHECKENABLED di anggota ullHintMask untuk menunjukkan minat pada anggota ini.

BusType

Nilai enumerasi VDS_STORAGE_BUS_TYPE yang menentukan jenis bus untuk LUN. Atur bendera VDS_HINT_BUSTYPE di anggota ullHintMask untuk menunjukkan minat pada anggota ini.

bReserved1

Anggota ini dicadangkan untuk digunakan di masa mendatang. Jangan gunakan.

bReserved2

Anggota ini dicadangkan untuk digunakan di masa mendatang. Jangan gunakan.

bReserved3

Anggota ini dicadangkan untuk digunakan di masa mendatang. Jangan gunakan.

sRebuildPriority

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

Keterangan

Metode IVdsHwProviderStoragePools::CreateLunInStoragePool melewati struktur ini sebagai parameter untuk memberikan petunjuk untuk membuat LUN di kumpulan penyimpanan. Ini diteruskan sebagai parameter dalam metode IVdsLun2::ApplyHints2 untuk menerapkan serangkaian petunjuk baru ke LUN. Selanjutnya, dikembalikan oleh metode IVdsLun2::QueryHints2 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

IVdsLun2::ApplyHints2

IVdsLun2::QueryHints2