SCSI_REQUEST_BLOCK-Struktur (srb.h)

Die SCSI_REQUEST_BLOCK-Struktur ist einer SRB-Funktion zugeordnet.

Syntax

typedef struct _SCSI_REQUEST_BLOCK {
  USHORT                     Length;
  UCHAR                      Function;
  UCHAR                      SrbStatus;
  UCHAR                      ScsiStatus;
  UCHAR                      PathId;
  UCHAR                      TargetId;
  UCHAR                      Lun;
  UCHAR                      QueueTag;
  UCHAR                      QueueAction;
  UCHAR                      CdbLength;
  UCHAR                      SenseInfoBufferLength;
  ULONG                      SrbFlags;
  ULONG                      DataTransferLength;
  ULONG                      TimeOutValue;
  PVOID                      DataBuffer;
  PVOID                      SenseInfoBuffer;
  struct _SCSI_REQUEST_BLOCK *NextSrb;
  PVOID                      OriginalRequest;
  PVOID                      SrbExtension;
  union {
    ULONG InternalStatus;
    ULONG QueueSortKey;
    ULONG LinkTimeoutValue;
  };
  ULONG                      Reserved;
  UCHAR                      Cdb[16];
} SCSI_REQUEST_BLOCK, *PSCSI_REQUEST_BLOCK;

Member

Length

Gibt die Größe dieser Struktur in Bytes an.

Function

Gibt den auszuführenden Vorgang an, der einer der folgenden Werte sein kann:

SrbStatus

Gibt den status der abgeschlossenen Anforderung zurück. Dieser Member sollte vom Miniporttreiber festgelegt werden, bevor er den betriebssystemspezifischen Treiber benachrichtigt, dass die Anforderung abgeschlossen wurde, indem ScsiPortNotification mit RequestComplete aufgerufen wird. Der Wert dieses Members kann einer der folgenden sein:

ScsiStatus

Gibt den SCSI-status zurück, der vom HBA oder dem Zielgerät zurückgegeben wurde. Wenn der status nicht SUCCESS ist, sollte der Miniporttreiber den SrbStatus-Member auf SRB_STATUS_ERROR festlegen.

PathId

Gibt den SCSI-Port oder Bus für die Anforderung an. Dieser Wert ist nullbasiert.

TargetId

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

Lun

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

QueueTag

Enthält den Warteschlangentagwert, der vom betriebssystemspezifischen Porttreiber zugewiesen wird. Wenn dieser Member für getaggte Warteschlangen verwendet wird, unterstützt der HBA interne Warteschlangen von Anforderungen an LUs, und der Miniporttreiber legt TaggedQueueing auf TRUE im PORT_CONFIGURATION_INFORMATION für diesen HBA fest.

QueueAction

Gibt die Getaggt-Warteschlangennachricht an, die beim Festlegen des SRB_FLAGS_QUEUE_ACTION_ENABLE-Flags verwendet werden soll. Der Wert kann einer der folgenden Sein: SRB_SIMPLE_TAG_REQUEST, SRB_HEAD_OF_QUEUE_TAG_REQUEST oder SRB_ORDERED_QUEUE_TAG_REQUEST, wie gemäß der SCSI-Spezifikation definiert.

CdbLength

Gibt die Größe des Befehlsdeskriptorblocks SCSI-2 oder höher in Bytes an.

SenseInfoBufferLength

Gibt die Größe des Request-Sense-Puffers in Bytes an. Wenn eine Unterausführung auftritt, muss der Miniporttreiber diesen Member auf die Anzahl der tatsächlich übertragenen Bytes aktualisieren.

SrbFlags

Gibt verschiedene Parameter und Optionen für die Anforderung an. SrbFlags ist schreibgeschützt, außer wenn SRB_FLAGS_UNSPECIFIED_DIRECTION festgelegt ist und Miniporttreiber untergeordneter DMA-Adapter erforderlich sind, um SRB_FLAGS_DATA_IN oder SRB_FLAGS_DATA_OUT zu aktualisieren. Für dieses Element können mindestens eine der folgenden Flags festgelegt sein:

DataTransferLength

Gibt die Größe des Datenpuffers in Byte an. 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. Miniporttreiber müssen keine Zeitanforderungen ausführen, da der Porttreiber dies bereits tut.

DataBuffer

Verweist auf den Datenpuffer. Miniporttreiber sollten diesen Wert nicht als Datenzeiger verwenden, es sei denn, der Miniporttreiber legt MapBuffers im PORT_CONFIGURATION_INFORMATION für den HBA auf TRUE fest. Bei SRB_FUNCTION_IO_CONTROL Anforderungen können Miniporttreiber diesen Wert jedoch unabhängig vom Wert von MapBuffers als Datenzeiger verwenden.

SenseInfoBuffer

Verweist auf den Anforderungsoptimierungspuffer. Ein Miniporttreiber ist nicht erforderlich, um Anforderungsoptimierungsdaten nach einer CHECK CONDITION bereitzustellen.

NextSrb

Gibt die SCSI_REQUEST_BLOCK an, für die diese Anforderung gilt. Nur eine kleine Teilmenge von Anforderungen verwendet einen zweiten SRB, z. B. SRB_FUNCTION_ABORT_COMMAND.

OriginalRequest

Verweist auf den IRP für diese Anforderung. Dieses Element ist für Miniporttreiber irrelevant.

SrbExtension

Verweist auf die Srb-Erweiterung. Ein Miniporttreiber darf diesen Member nicht verwenden, wenn er SrbExtensionSize im SCSI_HW_INITIALIZATION_DATA auf 0 festgelegt hat. Der Arbeitsspeicher bei SrbExtension wird nicht vom betriebssystemspezifischen Porttreiber initialisiert, und der HBA kann direkt auf die vom Miniporttreiber ermittelten Daten zugreifen. Die entsprechende physische Adresse kann durch Aufrufen von ScsiPortGetPhysicalAddress mit dem SrbExtension-Zeiger abgerufen werden.

InternalStatus

Wird vom SCSI-Porttreiber anstelle von SrbStatus verwendet, um die status der abgeschlossenen Anforderung zu melden, wenn die Anforderung nicht an den Miniporttreiber übermittelt werden kann. In solchen Fällen ist SrbStatus auf SRB_STATUS_INTERNAL_ERROR festgelegt. Dieser Member wird ausschließlich für die Kommunikation zwischen dem SCSI-Port und dem Klassentreiber verwendet und sollte nicht von Miniporttreibern verwendet werden.

QueueSortKey

Gibt je nach Typ des Zielgeräts den Offset vom Anfang des Mediums oder 0 (null) an.

LinkTimeoutValue

Linktimeoutwert.

Reserved

Reserviert.

Cdb[16]

Gibt den Befehlsdeskriptorblock SCSI-2 oder höher an, der an das Zielgerät gesendet werden soll.

Hinweise

Windows-Speicherklassen- und Filtertreiber können SRBs mit den folgenden Funktionswerten an den Systemporttreiber senden:

• SRB_FUNCTION_CLAIM_DEVICE, um anzugeben, dass der Klassentreiber ein Peripheriegerät unterstützt, das im SRB durch die Member PathId, TargetId und Lun identifiziert wird.
• SRB_ATTACH_DEVICE, um anzugeben, dass ein Filtertreiber, der über einem Klassentreiber liegt, Anforderungen für ein bestimmtes Peripheriegerät zuerst an den Filtertreiber weitergeleitet werden soll.
• SRB_FUNCTION_RELEASE_DEVICE, um anzugeben, dass ein Klassentreiber seinen Anspruch auf einem bestimmten Peripheriegerät freigibt.
• SRB_FUNCTION_FLUSH_QUEUE, um den Abbruch aller Anforderungen anzufordern, die sich derzeit im Porttreiber an ein bestimmtes Peripheriegerät in der Warteschlange befinden.
• SRB_FUNCTION_RELEASE_QUEUE, um anzufordern, dass der Porttreiber eine fixierte Warteschlange mit Anforderungen an ein bestimmtes Peripheriegerät freigibt.

Die obigen SRB_FUNCTION_XXX werden nie in SRBs festgelegt, die an SCSI-Miniporttreiber gesendet werden. SRB_FUNCTION_REMOVE_DEVICE wird für die Verwendung in zukünftigen Versionen des Systems definiert. Es wird auch nie in SRBs festgelegt, die an SCSI-Miniporttreiber gesendet werden. SRB_FUNCTION_WMI_REQUEST ist nur in SCSI_WMI_REQUEST_BLOCK gültig. Eine Speicherklasse oder ein Filtertreiber verwendet dies, um WMI-Anforderungen an den Porttreiber zu senden.

Anforderungen

Weitere Informationen

ExFreePool

ExInterlockedFreeToZone

HW_INITIALIZATION_DATA (SCSI)

PORT_CONFIGURATION_INFORMATION (SCSI)

SCSI_WMI_REQUEST_BLOCK

SRB_IO_CONTROL

ScsiPortGetPhysicalAddress

ScsiPortGetSrb

ScsiPortIoMapTransfer

ScsiPortNotification