Função StorPortValidateRange (storport.h)

A rotina StorPortValidateRange determina se um intervalo especificado de endereços de E/S está em uso por outro adaptador. Essa rotina está 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 miniporta. Os drivers de miniporta 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 miniporta 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.

Retornar valor

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

Comentários

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

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

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 do Storport usam para representar um endereço físico ou um endereço relativo ao barramento.

Requisitos

Requisito	Valor
Plataforma de Destino	Universal
Cabeçalho	storport.h (inclua Storport.h)
Biblioteca	Storport.lib
Regras de conformidade da DDI	StorPortDeprecated(storport)

Confira também

ScsiPortValidateRange