SCSI_PASS_THROUGH_EX Struktur (ntddscsi.h)
Die SCSI_PASS_THROUGH_EX-Struktur wird in Verbindung mit einer IOCTL_SCSI_PASS_THROUGH_EX Anforderung verwendet, den Porttreiber anzuweisen, einen eingebetteten SCSI-Befehl an das Zielgerät zu senden. SCSI_PASS_THROUGH_EX können bidirektionale Datenübertragungen und einen Datenblock mit variabler Länge enthalten.
Anmerkung
Die SCSI-Porttreiber- und SCSI-Miniporttreibermodelle können in Zukunft geändert oder nicht verfügbar sein. Verwenden Sie stattdessen den Storport-Treiber und Storport Miniport Treibermodelle.
Syntax
typedef struct _SCSI_PASS_THROUGH_EX {
ULONG Version;
ULONG Length;
ULONG CdbLength;
ULONG StorAddressLength;
UCHAR ScsiStatus;
UCHAR SenseInfoLength;
UCHAR DataDirection;
UCHAR Reserved;
ULONG TimeOutValue;
ULONG StorAddressOffset;
ULONG SenseInfoOffset;
ULONG DataOutTransferLength;
ULONG DataInTransferLength;
ULONG_PTR DataOutBufferOffset;
ULONG_PTR DataInBufferOffset;
UCHAR Cdb[ANYSIZE_ARRAY];
} SCSI_PASS_THROUGH_EX, *PSCSI_PASS_THROUGH_EX;
Angehörige
Version
Die Version dieser Struktur. Auf 0 festgelegt.
Length
Die Größe dieser Struktur in Byte. Auf sizeof(SCSI_PASS_THROUGH_EX)festgelegt.
CdbLength
Die Größe des SCSI-Befehlsdeskriptorblocks in Cdb-in Byte.
StorAddressLength
Die Länge der Speichergeräteadressenstruktur in Bytes beim Offset von StorAddressOffset nach dieser Struktur.
ScsiStatus
Meldet den SCSI-Status, der von der HBA oder dem Zielgerät zurückgegeben wurde.
SenseInfoLength
Die Größe in Byte des Anforderungsoptimierungspuffers. Dieses Element ist optional und kann auf 0 festgelegt werden.
DataDirection
Gibt an, ob der SCSI-Befehl Daten liest oder schreibt. Dieses Feld muss einen der folgenden Werte aufweisen:
| Wert | Bedeutung |
|---|---|
| SCSI_IOCTL_DATA_OUT | Schreiben sie Daten auf das Gerät. |
| SCSI_IOCTL_DATA_IN | Lesen von Daten vom Gerät. |
| SCSI_IOCTL_DATA_UNSPECIFIED | Es werden keine Daten übertragen. |
| SCSI_IOCTL_DATA_BIDIRECTIONAL | Daten sind sowohl für Die Eingabe als auch für die Ausgabe gültig. |
Reserved
Reserviert. Auf 0 festgelegt.
TimeOutValue
Gibt das Intervall in Sekunden an, das die Anforderung ausführen kann, bevor der Porttreiber es als Timeout betrachtet.
StorAddressOffset
Der Speicherort der Adressstruktur des Zielspeichergeräts in Byte vom Anfang dieser Struktur.
SenseInfoOffset
Versetzt vom Anfang dieser Struktur zum Anforderungsoptimierungspuffer. Legen Sie auf 0 fest, wenn kein Anforderungsoptimierungspuffer vorhanden ist.
DataOutTransferLength
Gibt die Größe in Bytes des Ausgabedatenpuffers an. Viele Geräte übertragen Datenblöcke mit vordefinierter Länge. Der Wert in DataOutTransferLength- muss ein integrales Vielfaches dieser vordefinierten Mindestlänge sein, die vom Gerät angegeben wird. Wenn ein Unterlauf auftritt, muss der Miniporttreiber dieses Element auf die Anzahl der tatsächlich übertragenen Bytes aktualisieren. Wenn kein Ausgabedatenpuffer vorhanden ist, wird dieses Element auf 0 festgelegt.
DataInTransferLength
Gibt die Größe in Byte des Eingabedatenpuffers an. Viele Geräte übertragen Datenblöcke mit vordefinierter Länge. Der Wert in DataInTransferLength- muss ein integrales Vielfaches dieser vordefinierten Mindestlänge sein, die vom Gerät angegeben wird. Wenn ein Unterlauf auftritt, muss der Miniporttreiber dieses Element auf die Anzahl der tatsächlich übertragenen Bytes aktualisieren. Wenn kein Eingabedatenpuffer vorhanden ist, wird dieses Element auf 0 festgelegt.
DataOutBufferOffset
Enthält einen Offset vom Anfang dieser Struktur bis zum Ausgabedatenpuffer. Der Offset muss die Datenausrichtungsanforderungen des Geräts einhalten.
DataInBufferOffset
Enthält einen Offset vom Anfang dieser Struktur bis zum Eingabedatenpuffer. Der Offset muss die Datenausrichtungsanforderungen des Geräts einhalten.
Cdb[ANYSIZE_ARRAY]
Gibt den SCSI-Befehlsdeskriptorblock an, der an das Zielgerät gesendet werden soll.
Bemerkungen
Die SCSI_PASS_THROUGH_EX-Struktur wird mit dem IOCTL_SCSI_PASS_THROUGH_EX Steuerelementcode verwendet, bei dem es sich um eine Anforderung für gepufferte Gerätesteuerelemente handelt. Um puffern im Systemspeicher zu umgehen, sollten Aufrufer IOCTL_SCSI_PASS_THROUGH_DIRECT_EXverwenden. Bei der Behandlung einer IOCTL_SCSI_PASS_THROUGH_DIRECT_EX Anforderung sperrt das System den Puffer im Benutzerspeicher und das Gerät greift direkt auf diesen Speicher zu.
Anmerkung
Treiber, die auf einer 64-Bit-Version von Windows ausgeführt werden, müssen die SCSI_PASS_THROUGH32_EX Struktur als Anforderungsdatentyp verwenden, wenn eine IOCTL_SCSI_PASS_THROUGH_EX Anforderung von einem 32-Bit-Prozess verarbeitet wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar ab Windows 8. |
| Header- | ntddscsi.h (include Ntddscsi.h) |