StorPortValidateRange, fonction (storport.h)

Article
02/07/2025

La routine StorPortValidateRange détermine si une plage d’adresses d’E/S spécifiée est utilisée par un autre adaptateur. Cette routine est obsolète dans les systèmes d’exploitation Windows NT 4.0 et versions ultérieures.

Syntaxe

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

Paramètres

[in] HwDeviceExtension

Pointeur vers l’extension de périphérique matériel. Il s’agit d’une zone de stockage par HBA que le pilote de port alloue et initialise pour le compte du pilote miniport. Les pilotes miniport stockent généralement des informations spécifiques à l’adaptateur HBA dans cette extension, telles que l’état de l’adaptateur HBA et les plages d’accès mappées pour l’adaptateur HBA. Cette zone est disponible pour le pilote miniport immédiatement après l’appel du pilote miniport StorPortInitialize. Le pilote de port libère cette mémoire lorsqu’il supprime l’appareil.

[in] BusType

Contient une valeur de type STORAGE_BUS_TYPE qui indique le type de bus.

SystemIoBusNumber

Contient un entier identifiant un bus système.

[in] IoAddress

Contient l’adresse de début de la plage d’adresses à valider.

[in] NumberOfBytes

Contient la longueur en octets de la plage d’adresses à valider.

[in] InIoSpace

Indique, quand TRUE, que la plage d’adresses est dans l’espace d’E/S. Si FAUX, l’adresse est dans l’espace mémoire.

Valeur de retour

StorPortValidateRange retourne TRUE si une plage d’adresses spécifiée n’est pas revendiquée par un autre pilote. Cette routine retourne FALSE si un autre pilote a revendiqué la plage d’adresses.

Remarques

Pour la compatibilité avec les versions antérieures de Windows, cette routine retourne toujours TRUE.

Les pilotes miniports reçoivent des plages d’E/S valides dans les AccessRanges membre de la structure PORT_CONFIGURATION_INFORMATION lorsque le pilote Storport appelle la routinede rappel HwStorFindAdapterdu miniport.

StorPortValidateRange utilise STOR_PHYSICAL_ADDRESS pour représenter des adresses relatives au bus.

typedef PHYSICAL_ADDRESS STOR_PHYSICAL_ADDRESS, *PSTOR_PHYSICAL_ADDRESS;

Le type STOR_PHYSICAL_ADDRESS est un type de données indépendant du système d’exploitation que les pilotes miniport Storport utilisent pour représenter une adresse physique ou une adresse relative au bus.

Exigences

Exigence	Valeur
plateforme cible	Universel
d’en-tête	storport.h (include Storport.h)
bibliothèque	Storport.lib
règles de conformité DDI	StorPortDeprecated(storport)

Voir aussi

ScsiPortValidateRange

Partager via