STORAGE_ADAPTER_DESCRIPTOR-Struktur (winioctl.h)
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 |
|---|---|
|
Puffer müssen an BYTE-Grenzen ausgerichtet werden. |
|
Puffer müssen an WORD-Grenzen ausgerichtet werden. |
|
Puffer müssen an DWORD32 Grenzen ausgerichtet werden. |
|
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 |
|---|---|
|
Der HBA verwendet SCSI-Anforderungsblöcke. |
|
Der HBA verwendet erweiterte SCSI-Anforderungsblöcke. |
Dieser Member ist ab Windows 8 gültig.
AddressType
Gibt den Adresstyp des HBA an.
| Wert | Bedeutung |
|---|---|
|
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) |