SCSI_PASS_THROUGH_DIRECT-Struktur (ntddscsi.h)

Artikel
02/26/2024

Die SCSI_PASS_THROUGH_DIRECT-Struktur wird in Verbindung mit einer IOCTL_SCSI_PASS_THROUGH_DIRECT-Anforderung verwendet, um den Porttreiber anzuweisen, einen eingebetteten SCSI-Befehl an das Zielgerät zu senden.

Hinweis

Der SCSI-Porttreiber und die SCSI-Miniporttreibermodelle können in Zukunft geändert oder nicht mehr verfügbar sein. Stattdessen wird empfohlen, die Modelle Storport-Treiber und Storport-Miniporttreiber zu verwenden.

Syntax

typedef struct _SCSI_PASS_THROUGH_DIRECT {
  USHORT Length;
  UCHAR  ScsiStatus;
  UCHAR  PathId;
  UCHAR  TargetId;
  UCHAR  Lun;
  UCHAR  CdbLength;
  UCHAR  SenseInfoLength;
  UCHAR  DataIn;
  ULONG  DataTransferLength;
  ULONG  TimeOutValue;
  PVOID  DataBuffer;
  ULONG  SenseInfoOffset;
  UCHAR  Cdb[16];
} SCSI_PASS_THROUGH_DIRECT, *PSCSI_PASS_THROUGH_DIRECT;

Member

Length

Enthält den Wert von sizeof(SCSI_PASS_THROUGH_DIRECT).

ScsiStatus

Meldet die SCSI-status, die vom HBA oder dem Zielgerät zurückgegeben wurde.

PathId

Gibt den SCSI-Port oder Bus für die Anforderung an.

TargetId

Gibt den Zielcontroller oder das Zielgerät auf dem Bus an.

Lun

Gibt die Nummer der logischen Einheit des Geräts an.

CdbLength

Gibt die Größe des SCSI-Befehlsdeskriptorblocks in Bytes an.

SenseInfoLength

Gibt die Größe des Request-Sense-Puffers in Bytes an.

DataIn

Gibt an, ob der SCSI-Befehl Daten liest oder schreibt. Dieses Feld muss einen von drei Werten aufweisen:

Datenübertragungstyp	Bedeutung
SCSI_IOCTL_DATA_IN	Lesen Sie Daten vom Gerät.
SCSI_IOCTL_DATA_OUT	Schreiben Sie Daten auf das Gerät.
SCSI_IOCTL_DATA_UNSPECIFIED	Keine Übertragenen Daten.

DataTransferLength

Gibt die Größe des Datenpuffers in Bytes an. Viele Geräte übertragen Datenblöcke vordefinierter Länge. Der Wert in DataTransferLength muss ein integrales Vielfaches dieser vordefinierten Mindestlänge sein, die vom Gerät angegeben wird. Wenn eine Unterausführung auftritt, muss der Miniporttreiber diesen Member auf die Anzahl der tatsächlich übertragenen Bytes aktualisieren.

TimeOutValue

Gibt das Intervall in Sekunden an, das die Anforderung ausführen kann, bevor der betriebssystemspezifische Porttreiber ein Timeout für möglich hält.

DataBuffer

Zeiger auf den Datenpuffer.

SenseInfoOffset

Enthält einen Offset vom Anfang dieser Struktur zum Anforderungs-Sense-Puffer.

Cdb[16]

Gibt den SCSI-Befehlsdeskriptorblock an, der an das Zielgerät gesendet werden soll.

Hinweise

Die SCSI_PASS_THROUGH_DIRECT-Struktur wird mit IOCTL_SCSI_PASS_THROUGH_DIRECT verwendet. Mit dieser Anforderung sperrt das System den Puffer im Benutzerspeicher, und das Gerät greift direkt auf diesen Speicher zu. Eine doppelt gepufferte Entsprechung dieser Gerätesteuerungsanforderung finden Sie unter IOCTL_SCSI_PASS_THROUGH und SCSI_PASS_THROUGH.

Die Elemente von SCSI_PASS_THROUGH_DIRECT entsprechen ungefähr den Elementen einer SCSI_REQUEST_BLOCK Struktur. Die Werte des DataIn-Members entsprechen den SCSI_IOCTL_DATA_IN-, SCSI_IOCTL_DATA_OUT- und SCSI_IOCTL_DATA_UNSPECIFIED Flags, die dem SrbFlags-Member von SCSI_REQUEST_BLOCK zugewiesen sind.