Partager via


IOCTL_SCSI_GET_CAPABILITIES IOCTL (ntddscsi.h)

Retourne les fonctionnalités et limitations de l’adaptateur HBA SCSI sous-jacent. Les informations les plus importantes sont retournées dans les membres MaximumTransferLength et AlignmentMask . Les pilotes de classe et les utilisateurs de IOCTL_SCSI_PASS_THROUGH et de IOCTL_SCSI_PASS_THROUGH_DIRECT sont tenus de respecter ces limitations.

Seuls les pilotes hérités peuvent émettre cette requête. La requête échoue s’il est envoyé à un PDO créé par le pilote de port.

Pour obtenir des données de fonctionnalités SCSI, un pilote Plug-and-Play doit émettre une demande de IOCTL_STORAGE_QUERY_PROPERTY pour STORAGE_ADAPTER_DESCRIPTOR données à l’objet PDO pour chaque périphérique auquel le pilote a été ajouté (autrement dit, chaque appareil pour lequel le pilote a reçu un appel AddDevice). Un pilote hérité doit transférer cette requête au pilote de port. Cette requête échoue si elle est envoyée à l’objet FDO d’un adaptateur.

Remarque Le pilote de port SCSI et les modèles de pilotes miniport SCSI peuvent être modifiés ou indisponibles à l’avenir. Au lieu de cela, nous vous recommandons d’utiliser le du pilote Storport et modèles de pilotes Storport miniport.
 

Code principal

IRP_MJ_DEVICE_CONTROL

Mémoire tampon d’entrée

Aucun.

Longueur de la mémoire tampon d’entrée

Aucun.

Mémoire tampon de sortie

Les informations de IO_SCSI_CAPABILITIES mises à jour sont retournées à la mémoire tampon à Irp->AssociatedIrp.SystemBuffer.

Longueur de la mémoire tampon de sortie

Parameters.DeviceIoControl.OutputBufferLength dans l’emplacement de la pile d’E/S indique la taille, en octets, de la mémoire tampon, qui doit être >= sizeof(IO_SCSI_CAPABILITIES).

Bloc d’état

Le champ Informations contient le nombre d’octets retournés dans la mémoire tampon de sortie. Le champ d’état indique les résultats de l’opération.

Exigences

Exigence Valeur
d’en-tête ntddscsi.h (include Ntddscsi.h)

Voir aussi

IO_SCSI_CAPABILITIES