Função StorPortValidateRange (storport.h)

Artigo
02/07/2025

A rotina StorPortValidateRange determina se um intervalo especificado de endereços de E/S está em uso por outro adaptador. Essa rotina é obsoleta no Windows NT 4.0 e em sistemas operacionais posteriores.

Sintaxe

STORPORT_API BOOLEAN StorPortValidateRange(
  [in] PVOID                 HwDeviceExtension,
  [in] INTERFACE_TYPE        BusType,
       ULONG                 SystemIoBusNumber,
  [in] STOR_PHYSICAL_ADDRESS IoAddress,
  [in] ULONG                 NumberOfBytes,
  [in] BOOLEAN               InIoSpace
);

Parâmetros

[in] HwDeviceExtension

Um ponteiro para a extensão do dispositivo de hardware. Essa é uma área de armazenamento por HBA que o driver de porta aloca e inicializa em nome do driver de miniporto. Os drivers de miniporto geralmente armazenam informações específicas do HBA nessa extensão, como o estado do HBA e os intervalos de acesso mapeados para o HBA. Essa área está disponível para o driver de miniporto imediatamente após o driver de miniporto chamar StorPortInitialize. O driver de porta libera essa memória quando remove o dispositivo.

[in] BusType

Contém um valor do tipo STORAGE_BUS_TYPE que indica o tipo de barramento.

SystemIoBusNumber

Contém um inteiro que identifica um barramento do sistema.

[in] IoAddress

Contém o endereço inicial do intervalo de endereços a serem validados.

[in] NumberOfBytes

Contém o comprimento em bytes do intervalo de endereços a serem validados.

[in] InIoSpace

Indica, quando TRUE, que o intervalo de endereços está no espaço de E/S. Se FALSE, o endereço estará no espaço de memória.

Valor de retorno

StorPortValidateRange retornará verdadeiro se um intervalo especificado de endereços não for reivindicado por outro driver. Essa rotina retornará FALSE se outro driver tiver reivindicado o intervalo de endereços.

Observações

Para compatibilidade com versões mais antigas do Windows, essa rotina sempre retorna VERDADEIRO.

Os drivers de miniporto recebem intervalos de E/S válidos no AccessRanges membro da estrutura de PORT_CONFIGURATION_INFORMATION quando o driver Storport chama o do miniporto HwStorFindAdapter rotina de retorno de chamada.

StorPortValidateRange usa STOR_PHYSICAL_ADDRESS para representar endereços relativos ao barramento.

typedef PHYSICAL_ADDRESS STOR_PHYSICAL_ADDRESS, *PSTOR_PHYSICAL_ADDRESS;

O tipo STOR_PHYSICAL_ADDRESS é um tipo de dados independente do sistema operacional que os drivers de miniporto storport usam para representar um endereço físico ou um endereço relativo ao barramento.

Requisitos

Requisito	Valor
da Plataforma de Destino	Universal
cabeçalho	storport.h (inclua Storport.h)
biblioteca	Storport.lib
regras de conformidade de DDI	StorPortDeprecated(storport)

Consulte também

ScsiPortValidateRange

Compartilhar via