estructura ACCESS_RANGE (storport.h)

Un ACCESS_RANGE describe un intervalo de puertos de E/S o memoria usado por un HBA.

Sintaxis

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

Miembros

RangeStart

Contiene una dirección física que especifica la dirección base relativa al bus de un intervalo utilizado por el HBA. El valor de este miembro se puede obtener de uno de los elementos AccessRanges de la estructura PORT_CONFIGURATION_INFORMATION . Se trata de una dirección que se puede pasar a StorPortGetDeviceBase.

RangeLength

Especifica el tamaño, en bytes o el número de puertos del intervalo. Un controlador de minipuerto debe asegurarse de que este valor coincida con el intervalo realmente descodificado por el adaptador. Por ejemplo, si el HBA usa siete registros, pero responde a ocho, este miembro debe establecerse en 8.

RangeInMemory

Indica que el intervalo está en memoria cuando es TRUE, en lugar de en el espacio de E/S. Cuando es FALSE, el intervalo está en espacio de E/S.

Comentarios

Cada ACCESS_RANGE es un elemento de matriz AccessRanges dentro de la estructura PORT_CONFIGURATION_INFORMATION que se pasa a una rutina HwStorFindAdapter del controlador de miniporte.

Storport asigna memoria para los intervalos de acceso e inicializa el miembro AccessRanges . La rutina HwStorFindAdapter del controlador de miniporte debe usar solo las direcciones proporcionadas y nunca debe intentar encontrar otras HBA en el mismo bus mediante direcciones de su propia desaprotección. Si intenta acceder a otros intervalos de memoria o puerto relativos al bus cuando el controlador de puerto ha proporcionado información de intervalo, especialmente en sistemas de solo x86 en los que algunos dispositivos se inicializan en modo real x86, pueden hacer que otros dispositivos del bus produzcan errores en la inicialización o incluso hacer que el sistema produzca un error en el proceso de arranque.

Requisitos

Consulte también

HwStorFindAdapter

PORT_CONFIGURATION_INFORMATION

StorPortGetDeviceBase