Freigeben über


SPB_TRANSFER_LIST Struktur (spb.h)

Die SPB_TRANSFER_LIST-Struktur beschreibt eine E/A-Übertragungssequenz.

Syntax

typedef struct SPB_TRANSFER_LIST {
  ULONG                   Size;
  ULONG                   Reserved;
  ULONG                   TransferCount;
  SPB_TRANSFER_LIST_ENTRY Transfers[1];
} SPB_TRANSFER_LIST, *PSPB_TRANSFER_LIST;

Angehörige

Size

Die Größe der SPB_TRANSFER_LIST Struktur in Byte. Dieser Größenwert enthält keine Übertragungen Arrayelemente, die dieser Struktur folgen können. Wenn neue Member zu zukünftigen Versionen dieser Struktur hinzugefügt werden, kann der wert Size verwendet werden, um zu bestimmen, welche Version der SPB_TRANSFER_LIST-Struktur verwendet wird.

Reserved

Reserviert für die Verwendung durch das Betriebssystem. Auf Null festgelegt.

TransferCount

Die Anzahl der Elemente im Transfer Arrays. Dieses Array enthält mindestens ein Element.

Transfers[1]

Dieses Element ist das erste Element in einem Array von SPB_TRANSFER_LIST_ENTRY Strukturen. Jedes Arrayelement beschreibt eine einzelne Übertragung in der E/A-Übertragungssequenz. Wenn das Array mehrere Elemente enthält, folgen die zusätzlichen Arrayelemente unmittelbar der SPB_TRANSFER_LIST Struktur im Arbeitsspeicher. Die Übertragungen werden in der Reihenfolge ausgeführt, in der sie im Array angezeigt werden, beginnend mit dem ersten Element.

Bemerkungen

Der Eingabepuffer für eine IOCTL_SPB_EXECUTE_SEQUENCE-Anforderung beginnt mit einer SPB_TRANSFER_LIST Struktur. Die erste Übertragung in der angeforderten E/A-Übertragungssequenz wird in der Transfers Mitglied dieser Struktur angegeben. Wenn die Sequenz mehrere Übertragungen enthält, folgen die Arrayelemente, die die zusätzlichen Übertragungen beschreiben, unmittelbar der SPB_TRANSFER_LIST Struktur.

Der Eingabepuffer für eine IOCTL_SPB_FULL_DUPLEX-Anforderung beginnt mit einer SPB_TRANSFER_LIST Struktur. Die SPB_TRANSFER_LIST Struktur für diese Anforderung gibt immer zwei Puffer an. Der erste Puffer, der vom Transfers Member dieser Struktur beschrieben wird, enthält die Daten, die auf das Gerät geschrieben werden sollen. Der zweite Puffer, der von einem Arrayelement beschrieben wird, das unmittelbar auf die SPB_TRANSFER_LIST Struktur folgt, wird verwendet, um die vom Gerät gelesenen Daten zu halten.

Wenn Ihr SPB-Controllertreiber benutzerdefinierte I/O-Steuerungsanforderungen (IOCTL) unterstützt, die Eingabe- oder Ausgabepuffer verwenden, verwenden Sie die SPB_TRANSFER_LIST Struktur, um diese Puffer zu beschreiben. Weitere Informationen finden Sie unter Using the SPB_TRANSFER_LIST Structure for Custom IOCTLs.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Wird ab Windows 8 unterstützt.
Header- spb.h

Siehe auch