struktur DEVICE_LB_PROVISIONING_DESCRIPTOR (winioctl.h)

Artikel
03/04/2024

Struktur DEVICE_LB_PROVISIONING_DESCRIPTOR adalah salah satu struktur hasil kueri yang dikembalikan dari permintaan IOCTL_STORAGE_QUERY_PROPERTY . Struktur ini berisi kemampuan provisi tipis untuk perangkat penyimpanan.

Sintaks

typedef struct _DEVICE_LB_PROVISIONING_DESCRIPTOR {
  DWORD     Version;
  DWORD     Size;
  BYTE      ThinProvisioningEnabled : 1;
  BYTE      ThinProvisioningReadZeros : 1;
  BYTE      AnchorSupported : 3;
  BYTE      UnmapGranularityAlignmentValid : 1;
  BYTE      GetFreeSpaceSupported : 1;
  BYTE      MapSupported : 1;
  BYTE      Reserved1[7];
  DWORDLONG OptimalUnmapGranularity;
  DWORDLONG UnmapGranularityAlignment;
  DWORD     MaxUnmapLbaCount;
  DWORD     MaxUnmapBlockDescriptorCount;
} DEVICE_LB_PROVISIONING_DESCRIPTOR, *PDEVICE_LB_PROVISIONING_DESCRIPTOR;

Anggota

Version

Berisi ukuran struktur ini, dalam byte. Nilai anggota ini akan berubah saat anggota ditambahkan ke struktur.

Size

Menentukan ukuran total data yang dikembalikan, dalam byte. Ini mungkin termasuk data yang mengikuti struktur ini.

ThinProvisioningEnabled

Status provisi tipis yang diaktifkan.

Nilai	Makna
0	Provisi tipis dinonaktifkan.
1	Provisi tipis diaktifkan.

ThinProvisioningReadZeros

Membaca ke wilayah yang belum dipetakan mengembalikan nol.

Nilai	Makna
0	Data yang dibaca dari wilayah yang tidak dipetakan tidak terdefinisi.
1	Membaca mengembalikan nol.

AnchorSupported

Pembacaan deterministik setelah memangkas dukungan.

Nilai	Makna
0	Pembacaan deterministik setelah pemangkasan tidak didukung.
1	Pembacaan deterministik setelah pemangkasan didukung.

UnmapGranularityAlignmentValid

Validitas perataan granularitas unmap untuk perangkat.

Nilai	Makna
0	Perataan granularitas tidak valid.
1	Perataan granularitas unmap valid.

GetFreeSpaceSupported

MapSupported

Reserved1[7]

Dicadangkan.

OptimalUnmapGranularity

Jumlah sektor logis yang optimal untuk granularitas unmap untuk perangkat.

UnmapGranularityAlignment

Nilai saat ini, di sektor logis, diatur untuk perataan granularitas unmap pada perangkat.

MaxUnmapLbaCount

Mulai dari Windows 10: Jumlah maksimum LBA yang dapat tidak dipetakan dalam satu perintah unmap, dalam blok logis.

MaxUnmapBlockDescriptorCount

Mulai dari Windows 10: Jumlah maksimum deskriptor yang diizinkan dalam satu perintah unmap.

Keterangan

Struktur ini dikembalikan dari permintaan IOCTL_STORAGE_QUERY_PROPERTY ketika anggota PropertyIdSTORAGE_PROPERTY_QUERY diatur ke StorageDeviceLBProvisioningProperty.

Jika UnmapGranularityAlignmentValid = 0, maka kode apa pun yang menggunakan UnmapGranularityAlignment harus mengasumsikan kode tersebut memiliki nilai 0.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [khusus aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Header	winioctl.h (termasuk Windows.h)

Lihat juga

Struktur Manajemen Disk

IOCTL_STORAGE_QUERY_PROPERTY

STORAGE_PROPERTY_QUERY

Bagikan melalui