IOCTL_SCSI_GET_CAPABILITIES IOCTL (ntddscsi.h)

Gibt die Funktionen und Einschränkungen der zugrunde liegenden SCSI-HBA zurück. Die wichtigsten Informationen werden in den MaximumTransferLength- und AlignmentMask--Membern zurückgegeben. Klassentreiber und Benutzer von IOCTL_SCSI_PASS_THROUGH und IOCTL_SCSI_PASS_THROUGH_DIRECT sind erforderlich, um diese Einschränkungen zu berücksichtigen.

Nur ältere Treiber können diese Anforderung ausstellen. Die Anforderung schlägt fehl, wenn sie an einen vom Porttreiber erstellten PDO gesendet wird.

Um SCSI-Funktionsdaten abzurufen, muss ein Plug-and-Play-Treiber eine IOCTL_STORAGE_QUERY_PROPERTY Anforderung für STORAGE_ADAPTER_DESCRIPTOR Daten an den PDO für jedes Gerät ausgeben, dem der Treiber hinzugefügt wurde (d. h. jedes Gerät, für das der Treiber einen AddDevice Anruf erhalten hat). Ein Legacytreiber sollte diese Anforderung an den Porttreiber weiterleiten. Diese Anforderung schlägt fehl, wenn sie für einen Adapter an den FDO gesendet wird.

Hinweis Der SCSI-Porttreiber und die SCSI-Miniporttreibermodelle können in Zukunft geändert oder nicht mehr verfügbar sein. Stattdessen empfehlen wir die Verwendung des Storport-Treibers und Storport Miniport Treibermodelle.

 

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Nichts.

Eingabepufferlänge

Nichts.

Ausgabepuffer

Aktualisierte IO_SCSI_CAPABILITIES Informationen werden an den Puffer bei Irp->AssociatedIrp.SystemBufferzurückgegeben.

Länge des Ausgabepuffers

Parameters.DeviceIoControl.OutputBufferLength- an der I/O-Stapelposition gibt die Größe des Puffers in Bytes an, die >= Sizeof(IO_SCSI_CAPABILITIES).

Statusblock

Das Feld Information enthält die Anzahl der im Ausgabepuffer zurückgegebenen Bytes. Das Feld Status gibt die Ergebnisse des Vorgangs an.

Anforderungen

Anforderung	Wert
Header-	ntddscsi.h (include Ntddscsi.h)

Siehe auch

IO_SCSI_CAPABILITIES