STORAGE_ADAPTER_DESCRIPTOR-Struktur (winioctl.h)

  • Artikel

Wird mit dem IOCTL_STORAGE_QUERY_PROPERTY-Steuerungscode zum Abrufen der Beschreibungsdaten für den Speicheradapter für ein Gerät verwendet.

Syntax

typedef struct _STORAGE_ADAPTER_DESCRIPTOR {
  DWORD   Version;
  DWORD   Size;
  DWORD   MaximumTransferLength;
  DWORD   MaximumPhysicalPages;
  DWORD   AlignmentMask;
  BOOLEAN AdapterUsesPio;
  BOOLEAN AdapterScansDown;
  BOOLEAN CommandQueueing;
  BOOLEAN AcceleratedTransfer;
#if ...
  BOOLEAN BusType;
#else
  BYTE    BusType;
#endif
  WORD    BusMajorVersion;
  WORD    BusMinorVersion;
  BYTE    SrbType;
  BYTE    AddressType;
} STORAGE_ADAPTER_DESCRIPTOR, *PSTORAGE_ADAPTER_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.

MaximumTransferLength

Gibt die maximale Anzahl von Bytes an, die der Speicheradapter in einem einzelnen Vorgang übertragen kann.

MaximumPhysicalPages

Gibt die maximale Anzahl von diskontinuierlichen physischen Seiten an, die der Speicheradapter in einer einzelnen Übertragung verwalten kann (d. h. den Umfang seiner Scatter-/Gather-Unterstützung).

AlignmentMask

Gibt die Ausrichtungsanforderungen des Speicheradapters für Übertragungen an. Die Ausrichtungsmaske gibt Ausrichtungseinschränkungen für Puffer an, die vom Speicheradapter für Übertragungsvorgänge benötigt werden. Gültige Maskenwerte werden auch durch Merkmale der Speicher-Manager in verschiedenen Versionen von Windows eingeschränkt.

Wert Bedeutung
0
 Puffer müssen an BYTE-Grenzen ausgerichtet werden.
1
 Puffer müssen an WORD-Grenzen ausgerichtet werden.
3
 Puffer müssen an DWORD32 Grenzen ausgerichtet werden.
7
 Puffer müssen an DWORD64 Grenzen ausgerichtet werden.

AdapterUsesPio

Wenn dieser Member TRUE ist, verwendet der Speicheradapter programmierte E/A (PIO) und erfordert die Verwendung von virtuellen Systemraumadressen, die dem physischen Speicher für Datenpuffer zugeordnet sind. Wenn dieser Member FALSE ist, verwendet der Speicheradapter keine PIO.

AdapterScansDown

Wenn dieser Member TRUE ist, scannt der Speicheradapter nach BIOS-Geräten, d. h. der Speicheradapter beginnt mit der überprüfung mit der höchsten Gerätenummer und nicht mit der niedrigsten. Wenn dieser Member FALSE ist, beginnt der Speicheradapter mit der Überprüfung mit der niedrigsten Gerätenummer. Dieser Member ist für Legacy-Miniporttreiber reserviert.

CommandQueueing

Wenn dieser Member AUF TRUE festgelegt ist, unterstützt der Speicheradapter SCSI-Warteschlangen und/oder interne Warteschlangen pro logischer Einheit oder die Nicht-SCSI-Entsprechung.If this member is TRUE, the storage adapter tagged SCSI queueing and/or per logical-unit internal queues or the non-SCSI equivalent. Wenn dieser Member FALSE ist, unterstützt der Speicheradapter weder SCSI-markierte Warteschlangen noch interne Warteschlangen pro logischer Einheit.

AcceleratedTransfer

Wenn dieser Member TRUE ist, unterstützt der Speicheradapter synchrone Übertragungen, um E/A zu beschleunigen. Wenn dieser Member FALSE ist, unterstützt der Speicheradapter keine synchronen Übertragungen, um E/A zu beschleunigen.

BusType

Gibt einen Wert vom Typ STORAGE_BUS_TYPE an, der den Typ des Busses angibt, mit dem das Gerät verbunden ist.

BusMajorVersion

Gibt ggf. die Hauptversionsnummer des Speicheradapters an.

BusMinorVersion

Gibt ggf. die Nebenversionsnummer des Speicheradapters an.

SrbType

Gibt den SCSI-Anforderungsblocktyp (SRB) an, der vom HBA verwendet wird.

Wert Bedeutung
SRB_TYPE_SCSI_REQUEST_BLOCK
 Der HBA verwendet SCSI-Anforderungsblöcke.
SRB_TYPE_STORAGE_REQUEST_BLOCK
 Der HBA verwendet erweiterte SCSI-Anforderungsblöcke.
 

Dieser Member ist ab Windows 8 gültig.

AddressType

Gibt den Adresstyp des HBA an.

Wert Bedeutung
STORAGE_ADDRESS_TYPE_BTL8
 Der HBA verwendet die 8-Bit-Bus-, Ziel- und LUN-Adressierung.
 

Dieser Member ist ab Windows 8 gültig.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Kopfzeile winioctl.h (windows.h einschließen)

Siehe auch

Strukturen für die Datenträgerverwaltung

IOCTL_STORAGE_QUERY_PROPERTY

STORAGE_ADAPTER_DESCRIPTOR

STORAGE_DESCRIPTOR_HEADER

STORAGE_DEVICE_ID_DESCRIPTOR