Función StorPortValidateRange (storport.h)

La rutina StorPortValidateRange determina si otro adaptador usa un intervalo especificado de direcciones de E/S. Esta rutina está obsoleta en los sistemas operativos Windows NT 4.0 y versiones posteriores.

Sintaxis

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

Puntero a la extensión de dispositivo de hardware. Se trata de un área de almacenamiento por HBA que el controlador de puerto asigna e inicializa en nombre del controlador de minipuerto. Los controladores de minipuerto suelen almacenar información específica de HBA en esta extensión, como el estado del HBA y los intervalos de acceso asignados para el HBA. Esta área está disponible para el controlador de minipuerto inmediatamente después de que el controlador de minipuerto llame a StorPortInitialize. El controlador de puerto libera esta memoria cuando quita el dispositivo.

[in] BusType

Contiene un valor de tipo STORAGE_BUS_TYPE que indica el tipo de bus.

SystemIoBusNumber

Contiene un entero que identifica un bus del sistema.

[in] IoAddress

Contiene la dirección inicial del intervalo de direcciones que se van a validar.

[in] NumberOfBytes

Contiene la longitud en bytes del intervalo de direcciones que se va a validar.

[in] InIoSpace

Indica, cuando es TRUE, que el intervalo de direcciones está en el espacio de E/S. Si es FALSE, la dirección está en espacio de memoria.

Valor devuelto

StorPortValidateRange devuelve TRUE si otro controlador no reclama un intervalo de direcciones especificado. Esta rutina devuelve FALSE si otro controlador ha reclamado el intervalo de direcciones.

Comentarios

Para la compatibilidad con versiones anteriores de Windows, esta rutina siempre devuelve TRUE.

Los controladores de minipuerto reciben intervalos de E/S válidos en el miembro AccessRanges de la estructura PORT_CONFIGURATION_INFORMATION cuando el controlador storport llama a la rutina de devolución de llamada HwStorFindAdapter del miniporte.

StorPortValidateRange usa STOR_PHYSICAL_ADDRESS para representar direcciones relativas al bus.

typedef PHYSICAL_ADDRESS STOR_PHYSICAL_ADDRESS, *PSTOR_PHYSICAL_ADDRESS;

El tipo de STOR_PHYSICAL_ADDRESS es un tipo de datos independiente del sistema operativo que usan los controladores de miniport de Storport para representar una dirección física o una dirección relativa al bus.

Requisitos

Consulte también

ScsiPortValidateRange