Share via


SCSI_REQUEST_BLOCK-Struktur (storport.h)

Hinweis

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

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 Byte an.

Function

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

Wert Bedeutung
SRB_FUNCTION_EXECUTE_SCSI (0x00) Eine E/A-Anforderung für SCSI-Geräte sollte auf der logischen Zieleinheit ausgeführt werden.
SRB_FUNCTION_ABORT_COMMAND (0x10) Eine SCSIMESS_ABORT Nachricht sollte gesendet werden, um die Anforderung abzubrechen, auf die das NextSrb-Element verweist. Wenn es sich um eine Tagged-Queue-Anforderung handelt, sollte stattdessen eine SCSIMESS_ABORT_WITH_TAG Nachricht verwendet werden. Wenn die angegebene Anforderung abgeschlossen wurde, sollte diese Anforderung normal abgeschlossen werden. Nur die Member SRB Function, PathId, TargetId, Lun und NextSrb sind gültig.
SRB_FUNCTION_RESET_DEVICE (0x13) Der ScsiPort-Treiber sendet diesen SRB nicht mehr an seine Miniports. Nur Storport-Miniporttreiber verwenden diesen SRB. Der SCSI-Zielcontroller sollte mithilfe der meldung SCSIMESS_BUS_DEVICE_RESET zurückgesetzt werden. Der Miniporttreiber sollte alle aktiven Anforderungen für den Zielcontroller abschließen. Nur die Member "SRB Function", "TargetId" und "PathId" sind gültig.
SRB_FUNCTION_RESET_LOGICAL_UNIT (0x20) Die logische Einheit sollte nach Möglichkeit zurückgesetzt werden. Der HBA-Miniporttreiber sollte alle aktiven Anforderungen für die logische Einheit abschließen. Nur die Member Function, PathId, TargetId und Lun des SRB sind gültig. Storport unterstützt diese Art der Zurücksetzung, der SCSI-Port hingegen nicht.
SRB_FUNCTION_RESET_BUS (0x12) Der SCSI-Bus sollte mithilfe der SCSIMESS_BUS_DEVICE_RESET-Meldung zurückgesetzt werden. Ein Miniporttreiber empfängt diese Anforderung nur, wenn für eine bestimmte Anforderung ein Timeout aufgetreten ist und bei einer nachfolgenden Anforderung zum Abbrechen der Timeoutanforderung ebenfalls ein Timeout aufgetreten ist. Nur die Elemente SRB-Funktion und PathId sind gültig.
SRB_FUNCTION_TERMINATE_IO (0x14) Eine SCSIMESS_TERMINATE_IO_PROCESS Nachricht sollte gesendet werden, um die Anforderung abzubrechen, auf die das NextSrb-Element verweist. Wenn die angegebene Anforderung bereits abgeschlossen ist, sollte diese Anforderung normal ausgeführt werden. Nur die Member SRB Function, PathId, TargetId, Lun und NextSrb sind gültig.
SRB_FUNCTION_RELEASE_RECOVERY (0x11) Eine SCSIMESS_RELEASE_RECOVERY Nachricht sollte an den Zielcontroller gesendet werden. Nur die Member SRB Function, PathId, TargetId und Lun sind gültig.
SRB_FUNCTION_RECEIVE_EVENT (0x03) Der HBA sollte darauf vorbereitet sein, eine asynchrone Ereignisbenachrichtigung vom adressierten Ziel zu empfangen. Der SRB DataBuffer-Member gibt an, wo die Daten platziert werden sollen.
SRB_FUNCTION_SHUTDOWN (0x07) Das System wird heruntergefahren. Diese Anforderung wird nur an einen Miniporttreiber gesendet, wenn CachesData im PORT_CONFIGURATION_INFORMATION für den HBA auf TRUE festgelegt ist. Ein solcher Miniporttreiber kann mehrere dieser Benachrichtigungen erhalten, bevor alle Systemaktivitäten tatsächlich beendet werden. Die letzte Benachrichtigung zum Herunterfahren erfolgt jedoch nach der letzten Start-E/A. Nur die Member SRB Function, PathId, TargetId und Lun sind gültig.
SRB_FUNCTION_FLUSH (0x08) Der Miniporttreiber sollte alle zwischengespeicherten Daten für das Zielgerät leeren. Diese Anforderung wird nur an den Miniporttreiber gesendet, wenn CachesData im PORT_CONFIGURATION_INFORMATION für den HBA auf TRUE festgelegt ist. Nur die Member SRB Function, PathId, TargetId und Lun sind gültig.
SRB_FUNCTION_IO_CONTROL (0x02) Die Anforderung ist eine E/A-Steuerungsanforderung, die aus einer Benutzermodusanwendung mit einem dedizierten HBA stammt. Der SRB DataBuffer zeigt auf einen SRB_IO_CONTROL-Header gefolgt vom Datenbereich. Der Wert in DataBuffer kann vom Treiber unabhängig vom Wert von MapBuffers verwendet werden. Nur die Member SRB Function, SrbFlags, TimeOutValue, DataBuffer und DataTransferLength sind gültig, zusammen mit dem SrbExtension-Member , wenn der Miniporttreiber bei der Initialisierung SRB-Erweiterungen angefordert hat. Wenn ein Miniporttreiber einen anwendungsdedienten HBA steuert, damit er diese Anforderung unterstützt, sollte der Miniporttreiber die Anforderung ausführen und den betriebssystemspezifischen Porttreiber benachrichtigen, wenn der SRB abgeschlossen ist. Dabei wird der normale Mechanismus von Aufrufen von ScsiPortNotification mit RequestComplete und NextRequest verwendet.
SRB_FUNCTION_LOCK_QUEUE (0x18) Enthält Anforderungen, die vom Porttreiber für eine bestimmte logische Einheit in die Warteschlange gestellt werden, normalerweise während eine Energieanforderung verarbeitet wird. Nur die Elemente SRB Length, Function, SrbFlags und OriginalRequest sind gültig. Wenn die Warteschlange gesperrt ist, werden nur Anforderungen mit SrbFlags ORed mit SRB_FLAGS_BYPASS_LOCKED_QUEUE verarbeitet. SCSI-Miniporttreiber verarbeiten keine SRB_FUNCTION_LOCK_QUEUE Anforderungen.
SRB_FUNCTION_UNLOCK_QUEUE (0x19) Gibt die Warteschlange des Porttreibers für eine logische Einheit frei, die zuvor mit SRB_FUNCTION_LOCK_QUEUE gesperrt war. Die SrbFlags der Entsperranforderung müssen mit SRB_FLAGS_BYPASS_LOCKED_QUEUE. Nur die Elemente SRB Length, Function, SrbFlags und OriginalRequest sind gültig. SCSI-Miniporttreiber verarbeiten keine SRB_FUNCTION_UNLOCK_QUEUE Anforderungen.
SRB_FUNCTION_DUMP_POINTERS (0x26) Eine Anforderung mit dieser Funktion wird an einen Storport-Miniporttreiber gesendet, der zum Steuern des Datenträgers verwendet wird, der die Absturzabbilddaten enthält. Die Anforderung sammelt Informationen, die vom Miniporttreiber benötigt werden, um Absturzabbild und Ruhezustand zu unterstützen. Weitere Informationen finden Sie in der MINIPORT_DUMP_POINTERS-Struktur. Ein physischer Miniporttreiber muss das STOR_FEATURE_DUMP_POINTERS-Flag im FeatureSupport-Member seiner HW_INITIALIZATION_DATA festlegen, um eine Anforderung mit dieser Funktion zu empfangen.
SRB_FUNCTION_FREE_DUMP_POINTERS (0x27) Eine Anforderung mit dieser Funktion wird an einen Storport-Miniporttreiber gesendet, um alle Ressourcen freizugeben, die während einer vorherigen Anforderung für SRB_FUNCTION_DUMP_POINTERS zugeordnet wurden.

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:

Wert Bedeutung
SRB_STATUS_PENDING Gibt an, dass die Anforderung ausgeführt wird. Der betriebssystemspezifische Porttreiber initialisiert SrbStatus mit diesem Wert.
SRB_STATUS_SUCCESS Gibt an, dass die Anforderung erfolgreich abgeschlossen wurde.
SRB_STATUS_ABORTED Gibt an, dass die Anforderung wie vom Porttreiber angewiesen abgebrochen wurde. Ein Miniporttreiber legt diese status im NextSrb für eine erfolgreiche SRB_FUNCTION_ABORT_COMMAND-Anforderung fest.
SRB_STATUS_ABORT_FAILED Gibt an, dass der Versuch, die Anforderung abzubrechen, fehlgeschlagen ist. Geben Sie diesen status für eine SRB_FUNCTION_ABORT_COMMAND-Anforderung zurück, wenn die angegebene Anforderung nicht gefunden werden kann.
SRB_STATUS_ERROR Gibt an, dass die Anforderung mit einem Fehler im SCSI-Bus-status abgeschlossen wurde.
SRB_STATUS_BUSY Gibt an, dass der Miniporttreiber oder das Zielgerät die Anforderung zu diesem Zeitpunkt nicht annehmen konnte. Der betriebssystemspezifische Porttreiber übermittelt die Anforderung später erneut.
SRB_STATUS_INTERNAL_ERROR Gibt an, dass der SCSI-Porttreiber die Anforderung nicht an den Miniporttreiber oder das Zielgerät übermitteln konnte. In solchen Fällen wird status in InternalStatus aufgezeichnet.
SRB_STATUS_INVALID_REQUEST Gibt an, dass der Miniporttreiber die angegebene Anforderung nicht unterstützt.
SRB_STATUS_NO_DEVICE Gibt an, dass das Gerät nicht reagiert hat.
SRB_STATUS_TIMEOUT Gibt das Zeitlimit der Anforderung an.
SRB_STATUS_SELECTION_TIMEOUT Gibt an, dass die SCSI-Geräteauswahl ein Timeout hat.
SRB_STATUS_COMMAND_TIMEOUT Gibt an, dass das Ziel den Befehl nicht innerhalb des Zeitlimits abgeschlossen hat.
SRB_STATUS_MESSAGE_REJECTED Gibt an, dass das Ziel eine Nachricht abgelehnt hat. Dies wird normalerweise nur für Nachrichtentypanforderungen wie SRB_FUNCTION_TERMINATE_IO zurückgegeben.
SRB_STATUS_BUS_RESET Gibt an, dass während der Ausführung dieser Anforderung eine Busrücksetzung erfolgt ist.
SRB_STATUS_PARITY_ERROR Gibt an, dass ein Paritätsfehler auf dem SCSI-Bus aufgetreten ist und dass ein Wiederholungsversuch fehlgeschlagen ist.
SRB_STATUS_REQUEST_SENSE_FAILED Gibt an, dass der Befehl request-sense fehlgeschlagen ist. Dies wird nur zurückgegeben, wenn der HBA die automatische Anforderungs sense ausführt und der Miniporttreiber AutoRequestSense im PORT_CONFIGURATION_INFORMATION für diesen HBA auf TRUE festgelegt hat.
SRB_STATUS_NO_HBA Gibt an, dass der HBA nicht reagiert.
SRB_STATUS_DATA_OVERRUN Gibt an, dass ein Datenüber- oder Unterlauffehler aufgetreten ist. Der Miniporttreiber muss auch das DataTransferLength-Element des SRB aktualisieren, um anzugeben, wie viele Daten tatsächlich übertragen wurden, wenn eine Unterausführung auftritt.
SRB_STATUS_UNEXPECTED_BUS_FREE Gibt an, dass das Ziel unerwartet getrennt wurde.
SRB_STATUS_PHASE_SEQUENCE_FAILURE Gibt an, dass der HBA einen Fehler beim Fehler der illegalen Phasensequenz erkannt hat.
SRB_STATUS_REQUEST_FLUSHED Gibt an, dass die Anforderung für status beendet wurde.
SRB_STATUS_BAD_FUNCTION Gibt an, dass der Code der SRB-Funktion nicht unterstützt wird.
SRB_STATUS_INVALID_PATH_ID Gibt an, dass die im SRB angegebene PathId nicht vorhanden ist.
SRB_STATUS_INVALID_TARGET_ID Gibt an, dass der TargetID-Wert im SRB ungültig ist.
SRB_STATUS_INVALID_LUN Gibt an, dass der Lun-Wert im SRB ungültig ist.
SRB_STATUS_ERROR_RECOVERY Gibt an, dass die Anforderung mit einem Fehler im SCSI-Bus status abgeschlossen wurde und dass die SCSI INITIATE RECOVERY-Nachricht empfangen wurde.
SRB_STATUS_AUTOSENSE_VALID Gibt an, dass die im SenseInfoBuffer zurückgegebenen Informationen gültig sind.
SRB_STATUS_QUEUE_FROZEN Ein Miniporttreiber sollte den SrbStatus-Memberniemals auf diesen Wert festlegen. Der Windows-Porttreiber kann diesen Wert festlegen, um einen Speicherklassentreiber darüber zu informieren, dass seine Anforderungswarteschlange für ein bestimmtes Peripheriegerät eingefroren wurde.

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:

Flag Bedeutung
SRB_FLAGS_QUEUE_ACTION_ENABLE Gibt an, dass Aktionen für getaggte Warteschlangen aktiviert werden sollen.
SRB_FLAGS_DISABLE_AUTOSENSE Gibt an, dass Anforderungssinnsinformationen nicht zurückgegeben werden sollen.
SRB_FLAGS_DATA_IN Gibt an, dass Daten vom Gerät an das System übertragen werden.
SRB_FLAGS_DATA_OUT Gibt an, dass Daten vom System auf das Gerät übertragen werden.
SRB_FLAGS_UNSPECIFIED_DIRECTION Für die Abwärtskompatibilität mit den ASPI/CAM-SCSI-Schnittstellen definiert, gibt dieses Flag an, dass die Übertragungsrichtung eine der vorherigen sein kann, da beide vorherigen Flags festgelegt sind. Wenn dieses Flag festgelegt ist, sollte ein Miniporttreiber die Übertragungsrichtung bestimmen, indem er die Datenphase für das Ziel auf dem SCSI-Bus untersucht. Wenn es sich bei seinem HBA um ein untergeordnetes DMA-Gerät handelt, muss ein solcher Miniporttreiber SRB_FLAGS_DATA_OUT oder SRB_FLAGS_DATA_IN auf den richtigen Wert aktualisieren, bevor er ScsiPortIoMapTransfer aufruft.
SRB_FLAGS_NO_DATA_TRANSFER Gibt an, dass bei dieser Anforderung keine Datenübertragung erfolgt. Wenn dies festgelegt ist, sind die Flags SRB_FLAGS_DATA_OUT, SRB_FLAGS_DATA_IN und SRB_FLAGS_UNSPECIFIED_DIRECTION eindeutig.
SRB_FLAGS_DISABLE_SYNCH_TRANSFER Gibt an, dass der HBA nach Möglichkeit asynchrone E/A-Vorgänge für diese Übertragungsanforderung ausführen soll. Wenn synchrone E/A zuvor ausgehandelt wurde, muss der HBA für asynchrone E/A-Vorgänge neu verhandeln, bevor die Übertragung ausgeführt wird.
SRB_FLAGS_DISABLE_DISCONNECT Gibt an, dass der HBA das Ziel während der Verarbeitung dieser Anforderung nicht vom SCSI-Bus trennen darf.
SRB_FLAGS_BYPASS_FROZEN_QUEUE Ist für Miniporttreiber irrelevant.
SRB_FLAGS_NO_QUEUE_FREEZE Ist für Miniporttreiber irrelevant.
SRB_FLAGS_IS_ACTIVE Ist für Miniporttreiber irrelevant.
SRB_FLAGS_ALLOCATED_FROM_ZONE Ist für Miniporttreiber irrelevant und für aktuelle Windows-Klassentreiber veraltet. Für einen Windows-Legacyklassentreiber gibt dies an, ob der SRB aus einem Zonenpuffer zugeordnet wurde. Wenn dieses Flag festgelegt ist, muss der Klassentreiber ExInterlockedFreeToZone aufrufen, um den SRB freizugeben. Andernfalls muss ExFreePool aufgerufen werden. Neue Klassentreiber sollten Lookaside-Listen anstelle von Zonenpuffern verwenden.
SRB_FLAGS_SGLIST_FROM_POOL Ist für Miniporttreiber irrelevant. Für einen Windows-Klassentreiber bedeutet dies, dass Arbeitsspeicher für eine Scatter/Gather-Liste aus einem nicht ausgestellten Pool zugewiesen wurde. Wenn dieses Flag festgelegt ist, muss der Klassentreiber ExFreePool aufrufen, um den Arbeitsspeicher nach Abschluss des SRB freizugeben.
SRB_FLAGS_BYPASS_LOCKED_QUEUE Ist für Miniporttreiber irrelevant. Für den Porttreiber gibt dieses Flag an, dass die Anforderung verarbeitet werden soll, unabhängig davon, ob die Warteschlange für logische Einheiten gesperrt ist. Ein Höherstufiger Treiber muss dieses Flag festlegen, um eine SRB_FUNCTION_UNLOCK_QUEUE Anforderung zu senden.
SRB_FLAGS_NO_KEEP_AWAKE Ist für Miniporttreiber irrelevant. Ein Windows-Klassentreiber verwendet dieses Flag, um den Porttreiber anzugeben, um den Leerlauf zu melden, anstatt das Gerät hochzuschalten, um diese Anforderung zu verarbeiten.
SRB_FLAGS_FREE_SENSE_BUFFER Gibt an, dass entweder der Port oder der Miniporttreiber einen Puffer für Sense-Daten zugewiesen hat. Dadurch wird der Klassentreiber darüber informiert, dass der Sense-Datenpuffer nach dem Extrahieren der Daten freigegeben werden muss.

DataTransferLength

Gibt die Größe des Datenpuffers in Bytes 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 sind nicht erforderlich, um Anforderungen zu zeitieren, da der Porttreiber dies bereits tut.

DataBuffer

Zeigt 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

Zeigt auf den Anforderungssinnpuffer. Ein Miniporttreiber ist nicht erforderlich, um Anforderungssinnsdaten 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 die IRP für diese Anforderung. Dieses Element ist für Miniporttreiber irrelevant.

SrbExtension

Zeigt auf die Srb-Erweiterung. Ein Miniporttreiber darf diesen Member nicht verwenden, wenn er SrbExtensionSize im SCSI_HW_INITIALIZATION_DATA auf Null 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 abgerufen werden, indem Sie ScsiPortGetPhysicalAddress mit dem SrbExtension-Zeiger aufrufen.

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. Dieses Element wird ausschließlich für die Kommunikation zwischen dem SCSI-Port und dem Klassentreiber verwendet und sollte nicht von Miniporttreibern verwendet werden.

QueueSortKey

Gibt den Offset vom Anfang des Mediums oder null an, abhängig vom Typ des Zielgeräts.

LinkTimeoutValue

Gibt den Timeoutwert an.

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 für ein bestimmtes Peripheriegerät freigibt.
  • SRB_FUNCTION_FLUSH_QUEUE, um den Abbruch aller Anforderungen anzufordern, die derzeit im Porttreiber an ein bestimmtes Peripheriegerät in die Warteschlange gestellt werden.
  • SRB_FUNCTION_RELEASE_QUEUE, um anzufordern, dass der Porttreiber eine eingefrorene Warteschlange mit Anforderungen an ein bestimmtes Peripheriegerät freigibt.

Die vorherigen SRB_FUNCTION_XXX werden nie in SRBs festgelegt, die an SCSI-Miniporttreiber gesendet werden. SRB_FUNCTION_REMOVE_DEVICE für die Verwendung in zukünftigen Versionen des Systems definiert ist. 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

Anforderung Wert
Header storport.h (include Srb.h, Minitape.h, Storport.h)

Weitere Informationen

ExFreePool

HW_INITIALIZATION_DATA (SCSI)

PORT_CONFIGURATION_INFORMATION (SCSI)

SCSI_WMI_REQUEST_BLOCK

SRB_IO_CONTROL

ScsiPortGetPhysicalAddress

ScsiPortGetSrb

ScsiPortIoMapTransfer

ScsiPortNotification