SCSI_PASS_THROUGH-Struktur (ntddscsi.h)

Artikel
02/29/2024

Die SCSI_PASS_THROUGH-Struktur wird in Verbindung mit einer IOCTL_SCSI_PASS_THROUGH-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 {
  USHORT    Length;
  UCHAR     ScsiStatus;
  UCHAR     PathId;
  UCHAR     TargetId;
  UCHAR     Lun;
  UCHAR     CdbLength;
  UCHAR     SenseInfoLength;
  UCHAR     DataIn;
  ULONG     DataTransferLength;
  ULONG     TimeOutValue;
  ULONG_PTR DataBufferOffset;
  ULONG     SenseInfoOffset;
  UCHAR     Cdb[16];
} SCSI_PASS_THROUGH, *PSCSI_PASS_THROUGH;

Member

Length

Enthält den Wert von sizeof(SCSI_PASS_THROUGH).

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

Dieses Feld muss einen von drei Werten aufweisen:

#######

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 Porttreiber ein Timeout für möglich hält.

DataBufferOffset

Enthält einen Offset vom Anfang dieser Struktur zum Datenpuffer. Der Offset muss die Datenausrichtungsanforderungen des Geräts berücksichtigen.

SenseInfoOffset

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-Struktur wird mit IOCTL_SCSI_PASS_THROUGH verwendet, bei der es sich um eine gepufferte Gerätesteuerungsanforderung handelt. Um das Puffern im Systemspeicher zu umgehen, sollten Aufrufer IOCTL_SCSI_PASS_THROUGH_DIRECT verwenden. Bei der Behandlung einer IOCTL_SCSI_PASS_THROUGH_DIRECT-Anforderung sperrt das System den Puffer im Benutzerspeicher, und das Gerät greift direkt auf diesen Speicher zu.

Die Elemente von SCSI_PASS_THROUGH 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.