DEVICE_LB_PROVISIONING_DESCRIPTOR-Struktur (winioctl.h)

Artikel
03/06/2024

Die DEVICE_LB_PROVISIONING_DESCRIPTOR-Struktur ist eine der Abfrageergebnisstrukturen, die von einer IOCTL_STORAGE_QUERY_PROPERTY-Anforderung zurückgegeben werden. Diese Struktur enthält die Funktionen für die dünne Bereitstellung für ein Speichergerät.

Syntax

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;

Member

Version

Enthält die Größe dieser Struktur in Bytes. Der Wert dieses Members ändert sich, wenn Member der Struktur hinzugefügt werden.

Size

Gibt die Gesamtgröße der zurückgegebenen Daten in Bytes an. Dies kann Daten umfassen, die dieser Struktur folgen.

ThinProvisioningEnabled

Die thin provisioning-enabled status.

Wert	Bedeutung
0	Thin Provisioning ist deaktiviert.
1	Thin Provisioning ist aktiviert.

ThinProvisioningReadZeros

Lesevorgänge in nicht zugeordnete Regionen geben Nullen zurück.

Wert	Bedeutung
0	Daten, die aus nicht zugeordneten Regionen gelesen werden, sind nicht definiert.
1	Lesevorgänge geben Nullen zurück.

AnchorSupported

Deterministische Leseunterstützung nach dem Kürzen.

Wert	Bedeutung
0	Deterministisches Lesen nach dem Trimmen wird nicht unterstützt.
1	Deterministisches Lesen nach dem Trimmen wird unterstützt.

UnmapGranularityAlignmentValid

Die Gültigkeit der Zuordnungsgranularitätsausrichtung für das Gerät.

Wert	Bedeutung
0	Die Zuordnungsgranularitätsausrichtung ist ungültig.
1	Die Zuordnungsgranularitätsausrichtung ist gültig.

GetFreeSpaceSupported

MapSupported

Reserved1[7]

Reserviert.

OptimalUnmapGranularity

Die optimale Anzahl logischer Sektoren zum Aufheben der Zuordnungsgranularität für das Gerät.

UnmapGranularityAlignment

Der aktuelle Wert in logischen Sektoren wird für die Granularitätsausrichtung auf dem Gerät festgelegt.

MaxUnmapLbaCount

Ab Windows 10: Die maximale Anzahl von LBAs, die in einem einzelnen Unmap-Befehl in logischen Blöcken nicht zugeordnet werden können.

MaxUnmapBlockDescriptorCount

Ab Windows 10: Die maximale Anzahl von Deskriptoren, die in einem einzelnen Unmap-Befehl zulässig sind.

Hinweise

Diese Struktur wird von einer IOCTL_STORAGE_QUERY_PROPERTY-Anforderung zurückgegeben, wenn das PropertyId-Element von STORAGE_PROPERTY_QUERY auf StorageDeviceLBProvisioningProperty festgelegt ist.

Wenn UnmapGranularityAlignmentValid = 0 ist, sollte jeder Code, der UnmapGranularityAlignment verwendet, davon ausgehen, dass er den Wert 0 aufweist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Kopfzeile	winioctl.h (einschließlich Windows.h)

Siehe auch

Strukturen für die Datenträgerverwaltung

IOCTL_STORAGE_QUERY_PROPERTY

STORAGE_PROPERTY_QUERY

Freigeben über