Partager via


structure ACCESS_RANGE (storport.h)

Une ACCESS_RANGE décrit une plage de ports mémoire ou E/S utilisée par un adaptateur HBA.

Syntaxe

typedef struct _ACCESS_RANGE {
  STOR_PHYSICAL_ADDRESS RangeStart;
  ULONG                 RangeLength;
  BOOLEAN               RangeInMemory;
} ACCESS_RANGE, *PACCESS_RANGE;

Membres

RangeStart

Contient une adresse physique qui spécifie l’adresse de base relative du bus d’une plage utilisée par l’adaptateur HBA. La valeur de ce membre peut être obtenue à partir de l’un des éléments AccessRanges de la structure PORT_CONFIGURATION_INFORMATION . Il s’agit d’une adresse qui peut être transmise à StorPortGetDeviceBase.

RangeLength

Spécifie la taille, en octets ou le nombre de ports dans la plage. Un pilote miniport doit s’assurer que cette valeur correspond à la plage réellement décodée par l’adaptateur. Par exemple, si l’adaptateur HBA utilise sept registres mais répond à huit, ce membre doit être défini sur 8.

RangeInMemory

Indique que la plage est en mémoire quand TRUE, plutôt que dans l’espace d’E/S. Lorsque la valeur EST FALSE, la plage se trouve dans l’espace E/S.

Remarques

Chaque ACCESS_RANGE est un élément de tableau AccessRanges au sein de la structure PORT_CONFIGURATION_INFORMATION qui est passé à la routine HwStorFindAdapter d’un pilote miniport.

Storport alloue de la mémoire pour les plages d’accès et initialise le membre AccessRanges . La routine HwStorFindAdapter du pilote miniport doit utiliser uniquement les adresses fournies et ne doit jamais tenter de trouver d’autres adaptateurs HBA sur le même bus à l’aide d’adresses de sa propre conception. La tentative d’accès à d’autres ports relatifs au bus ou à d’autres plages de mémoire lorsque le pilote de port a fourni des informations de plage, en particulier dans les systèmes x86 uniquement dans lesquels certains appareils sont initialisés en mode réel x86, peut entraîner l’échec de l’initialisation d’autres appareils sur le bus ou même provoquer l’échec du processus de démarrage du système.

Configuration requise

Condition requise Valeur
En-tête storport.h (include Srb.h, Storport.h, Strmini.h)

Voir aussi

HwStorFindAdapter

PORT_CONFIGURATION_INFORMATION

StorPortGetDeviceBase