STORAGE_ACCESS_ALIGNMENT_DESCRIPTOR-Struktur (ntddstor.h)

Artikel
02/29/2024

Die STORAGE_ACCESS_ALIGNMENT_DESCRIPTOR-Struktur wird in Verbindung mit der IOCTL_STORAGE_QUERY_PROPERTY-Anforderung verwendet, um die Speicherzugriffsausrichtungsdeskriptordaten für ein Gerät abzurufen.

Syntax

typedef struct _STORAGE_ACCESS_ALIGNMENT_DESCRIPTOR {
  ULONG Version;
  ULONG Size;
  ULONG BytesPerCacheLine;
  ULONG BytesOffsetForCacheAlignment;
  ULONG BytesPerLogicalSector;
  ULONG BytesPerPhysicalSector;
  ULONG BytesOffsetForSectorAlignment;
} STORAGE_ACCESS_ALIGNMENT_DESCRIPTOR, *PSTORAGE_ACCESS_ALIGNMENT_DESCRIPTOR;

Member

Version

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

Size

Gibt die Gesamtgröße des Deskriptors in Bytes an.

BytesPerCacheLine

Die Anzahl der Bytes in einer Cachezeile des Geräts.

BytesOffsetForCacheAlignment

Der Adressoffset, der für eine ordnungsgemäße Ausrichtung des Cachezugriffs in Bytes erforderlich ist.

BytesPerLogicalSector

Die Anzahl der Bytes in einem logischen Sektor des Geräts.

BytesPerPhysicalSector

Die Anzahl der Bytes in einem physischen Sektor des Geräts.

BytesOffsetForSectorAlignment

Der logische Sektoroffset innerhalb des ersten physischen Sektors, in dem der erste logische Sektor platziert wird, in Bytes.

Beispiel: Offset = 3 logische Sektoren

+- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
|LBA      |X|X|X|0|1|2|3|4|5|6|7|8|9|10|11|12|13|14|15|16|17|
|- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
|Physical |               |                  |
|Sector   |      0        |        1         |         2
+- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

In diesem Beispiel ist BytesOffsetForSectorAlignment = 3 * size_of_logical_sector.

Hinweise

Speicherklassentreiber stellen eine Gerätesteuerungsanforderung mit dem E/A-Steuerungscode IOCTL_STORAGE_QUERY_PROPERTY aus, um diese Struktur abzurufen, die Zugriffsausrichtungsinformationen für Datenübertragungsvorgänge enthält. Die -Struktur kann entweder aus dem Geräteobjekt für den Bus oder aus einer FDO abgerufen werden, die die Anforderung an den zugrunde liegenden Bus weiterleitet.

Anforderungen

Anforderung	Wert
Header	ntddstor.h (einschließen von Ntddstor.h)

Weitere Informationen

IOCTL_STORAGE_QUERY_PROPERTY

Freigeben über