SRB_IO_CONTROL-Struktur (ntddscsi.h)

Artikel
02/26/2024

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 _SRB_IO_CONTROL {
  ULONG HeaderLength;
  UCHAR Signature[8];
  ULONG Timeout;
  ULONG ControlCode;
  ULONG ReturnCode;
  ULONG Length;
} SRB_IO_CONTROL, *PSRB_IO_CONTROL;

Member

HeaderLength

Is sizeof(SRB_IO_CONTROL).

Signature[8]

Gibt den anwendungsdedienten Ziel-HBA für diese Anforderung an. Diese Signatur wird verwendet, um Konflikte in ControlCode-Werten zwischen Anbietern zu verhindern. Es sollte sich um eine Zeichenfolge von ASCII-Zeichen handeln. Wenn ein Miniporttreiber den Eingabesignaturwert nicht erkennt, muss er die Anforderung mit einem status SRB_STATUS_INVALID_REQUEST abschließen.

Timeout

Gibt das Intervall in Sekunden an, das die Anforderung ausführen kann, bevor der betriebssystemspezifische Porttreiber ein Timeout für möglich hält. Miniport-Treiber sollten Timeouts für SRB_IO_CONTROL erzwingen, insbesondere für alle privat definierten SRB_IO_CONTROL.

ControlCode

Gibt den auszuführenden Vorgang an. Es gibt keine systemdefinierte Vorgänge. Werte müssen vom Treiber als Eine Reihe privater E/A-Steuerungscodes definiert werden, mit denen die Anwendung Anforderungen durch Aufrufen der Win32 DeviceIoControl-Funktion stellen kann. Weitere Informationen zum Definieren privater E/A-Steuerungscodes für Gerätesteuerungsanforderungen finden Sie unter Verwenden von E/A-Steuerungscodes.

ReturnCode

Gibt einen status Code zur Prüfung durch den antragstellenden Antrag zurück.

Length

Gibt die Größe des unmittelbar folgenden Datenbereichs in Byte an. Dieser Bereich kann für den jeweiligen Vorgang in Eingabe- und Ausgabebereiche unterteilt werden. Bei Eingabeanforderungen wird der Inhalt des DataBuffers auf den anforderer bis zum zurückgegebenen Wert von DataTransferLength kopiert.

Hinweise

Diese Struktur wird von Anwendungen verwendet, um Anforderungen direkt an einen anwendungsdedienten HBA zu senden. Beachten Sie, dass eine solche Anwendung auch Anforderungen einrichten muss, um ihren dedizierten HBA zu programmieren.

Anforderungen

Anforderung	Wert
Header	ntddscsi.h (einschließen von Ntddscsi.h)

Weitere Informationen

E/A-Steuerungscodes für SCSI-Ports

SCSI_REQUEST_BLOCK

Freigeben über