Compartilhar via


estrutura ACCESS_RANGE (storport.h)

Um ACCESS_RANGE descreve um intervalo de portas de E/S ou memória usado por um HBA.

Sintaxe

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

Membros

RangeStart

Contém um endereço físico que especifica o endereço base relativo ao barramento de um intervalo usado pelo HBA. O valor desse membro pode ser obtido de um dos elementos do AccessRanges na estrutura PORT_CONFIGURATION_INFORMATION. Este é um endereço que pode ser passado para StorPortGetDeviceBase.

RangeLength

Especifica o tamanho, em bytes ou o número de portas no intervalo. Um driver de miniporto deve garantir que esse valor corresponda ao intervalo realmente decodificado pelo adaptador. Por exemplo, se o HBA usar sete registros, mas responder a oito, esse membro deverá ser definido como 8.

RangeInMemory

Indica que o intervalo está na memória quando TRUE, em vez de no espaço de E/S. Quando FALSE, o intervalo está no espaço de E/S.

Observações

Cada ACCESS_RANGE é um elemento de matriz do AccessRanges dentro da estrutura PORT_CONFIGURATION_INFORMATION que é passada para a rotina dedeHwStorFindAdapter de um driver de miniport.

O Storport aloca memória para os intervalos de acesso e inicializa o membro AccessRanges. A rotina de do HwStorFindAdapter do motorista do miniport deve usar apenas os endereços fornecidos e nunca nunca tentar encontrar outros HBAs no mesmo ônibus usando endereços de sua própria criação. A tentativa de acessar outros intervalos de memória ou porta relativa ao barramento quando o driver de porta tiver fornecido informações de intervalo, particularmente em sistemas somente x86 nos quais alguns dispositivos são inicializados no modo real x86, pode fazer com que outros dispositivos no barramento falhem na inicialização ou até mesmo fazer com que o sistema falhe no processo de inicialização.

Requisitos

Requisito Valor
cabeçalho storport.h (incluem Srb.h, Storport.h, Strmini.h)

Consulte também

HwStorFindAdapter

PORT_CONFIGURATION_INFORMATION

StorPortGetDeviceBase