Freigeben über


IOCTL_SCSI_GET_CAPABILITIES IOCTL (ntddscsi.h)

Gibt die Funktionen und Einschränkungen des zugrunde liegenden SCSI-HBA zurück. Die wichtigsten Informationen werden in den Membern MaximumTransferLength und AlignmentMask zurückgegeben. Klassentreiber und Benutzer von IOCTL_SCSI_PASS_THROUGH und IOCTL_SCSI_PASS_THROUGH_DIRECT müssen diese Einschränkungen einhalten.

Nur Legacytreiber können diese Anforderung ausstellen. Die Anforderung schlägt fehl, wenn sie an ein PDO gesendet wird, das vom Porttreiber erstellt wurde.

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

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.
 

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Keine.

Eingabepufferlänge

Keine.

Ausgabepuffer

Aktualisiert IO_SCSI_CAPABILITIES Informationen an den Puffer unter Irp-AssociatedIrp.SystemBuffer> zurückgegeben werden.

Länge des Ausgabepuffers

Parameters.DeviceIoControl.OutputBufferLength im E/A-Stapelspeicherort gibt die Größe des Puffers in Bytes an, die = sizeof(IO_SCSI_CAPABILITIES) sein >muss.

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)

Weitere Informationen

IO_SCSI_CAPABILITIES