structure STORAGE_ADAPTER_DESCRIPTOR (winioctl.h)

  • Article

Utilisé avec le code de contrôle IOCTL_STORAGE_QUERY_PROPERTY pour récupérer les données de descripteur de l’adaptateur de stockage d’un dispositif.

Syntaxe

typedef struct _STORAGE_ADAPTER_DESCRIPTOR {
  DWORD   Version;
  DWORD   Size;
  DWORD   MaximumTransferLength;
  DWORD   MaximumPhysicalPages;
  DWORD   AlignmentMask;
  BOOLEAN AdapterUsesPio;
  BOOLEAN AdapterScansDown;
  BOOLEAN CommandQueueing;
  BOOLEAN AcceleratedTransfer;
#if ...
  BOOLEAN BusType;
#else
  BYTE    BusType;
#endif
  WORD    BusMajorVersion;
  WORD    BusMinorVersion;
  BYTE    SrbType;
  BYTE    AddressType;
} STORAGE_ADAPTER_DESCRIPTOR, *PSTORAGE_ADAPTER_DESCRIPTOR;

Membres

Version

Contient la taille de cette structure, en octets. La valeur de ce membre change à mesure que des membres sont ajoutés à la structure.

Size

Spécifie la taille totale des données retournées, en octets. Cela peut inclure des données qui suivent cette structure.

MaximumTransferLength

Spécifie le nombre maximal d’octets que l’adaptateur de stockage peut transférer en une seule opération.

MaximumPhysicalPages

Spécifie le nombre maximal de pages physiques discontinues que l’adaptateur de stockage peut gérer dans un seul transfert (en d’autres termes, l’étendue de sa prise en charge des points/regroupements).

AlignmentMask

Spécifie les exigences d’alignement de l’adaptateur de stockage pour les transferts. Le masque d’alignement indique les restrictions d’alignement pour les mémoires tampons requises par l’adaptateur de stockage pour les opérations de transfert. Les valeurs de masque valides sont également limitées par les caractéristiques des gestionnaires de mémoire sur différentes versions de Windows.

Valeur Signification
0
 Les mémoires tampons doivent être alignées sur les limites BYTE .
1
 Les mémoires tampons doivent être alignées sur les limites WORD .
3
 Les mémoires tampons doivent être alignées sur les limites de DWORD32 .
7
 Les mémoires tampons doivent être alignées sur les limites de DWORD64 .

AdapterUsesPio

Si ce membre a la valeur TRUE, l’adaptateur de stockage utilise des E/S programmées (PIO) et nécessite l’utilisation d’adresses virtuelles d’espace système mappées à la mémoire physique pour les mémoires tampons de données. Lorsque ce membre a la valeur FALSE, l’adaptateur de stockage n’utilise pas PIO.

AdapterScansDown

Si ce membre a la valeur TRUE, l’adaptateur de stockage analyse les périphériques BIOS, c’est-à-dire que l’adaptateur de stockage commence l’analyse avec le numéro d’appareil le plus élevé plutôt que le plus bas. Lorsque ce membre a la valeur FALSE, l’adaptateur de stockage commence l’analyse avec le numéro d’appareil le plus bas. Ce membre est réservé aux pilotes miniport hérités.

CommandQueueing

Si ce membre a la valeur TRUE, l’adaptateur de stockage prend en charge la file d’attente marquée SCSI et/ou les files d’attente internes par unité logique, ou l’équivalent non SCSI. Lorsque ce membre a la valeur FALSE, l’adaptateur de stockage ne prend pas en charge la file d’attente marquée par SCSI ni les files d’attente internes par unité logique.

AcceleratedTransfer

Si ce membre a la valeur TRUE, l’adaptateur de stockage prend en charge les transferts synchrones comme un moyen d’accélérer les E/S. Lorsque ce membre a la valeur FALSE, l’adaptateur de stockage ne prend pas en charge les transferts synchrones comme moyen d’accélérer les E/S.

BusType

Spécifie une valeur de type STORAGE_BUS_TYPE qui indique le type du bus auquel l’appareil est connecté.

BusMajorVersion

Spécifie le numéro de version principal, le cas échéant, de l’adaptateur de stockage.

BusMinorVersion

Spécifie le numéro de version secondaire, le cas échéant, de l’adaptateur de stockage.

SrbType

Spécifie le type de bloc de requête SCSI (SRB) utilisé par l’adaptateur HBA.

Valeur Signification
SRB_TYPE_SCSI_REQUEST_BLOCK
 L’adaptateur HBA utilise des blocs de requête SCSI.
SRB_TYPE_STORAGE_REQUEST_BLOCK
 L’adaptateur HBA utilise des blocs de requête SCSI étendus.
 

Ce membre est valide à partir de Windows 8.

AddressType

Spécifie le type d’adresse de l’adaptateur HBA.

Valeur Signification
STORAGE_ADDRESS_TYPE_BTL8
 L’adaptateur HBA utilise le bus 8 bits, la cible et l’adressage LUN.
 

Ce membre est valide à partir de Windows 8.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
En-tête winioctl.h (inclure Windows.h)

Voir aussi

Structures de gestion des disques

IOCTL_STORAGE_QUERY_PROPERTY

STORAGE_ADAPTER_DESCRIPTOR

STORAGE_DESCRIPTOR_HEADER

STORAGE_DEVICE_ID_DESCRIPTOR