Fonction StorPortValidateRange (storport.h)

Article
08/07/2023

La routine StorPortValidateRange détermine si une plage spécifiée d’adresses d’E/S 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 que le pilote miniport a appelé 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 se trouve dans l’espace d’E/S. Si la valeur est FALSE, l’adresse se trouve dans l’espace mémoire.

Valeur retournée

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 miniport reçoivent des plages d’E/S valides dans le membre AccessRanges de la structure PORT_CONFIGURATION_INFORMATION lorsque le pilote Storport appelle la routine de rappel HwStorFindAdapter du miniport.

StorPortValidateRange utilise STOR_PHYSICAL_ADDRESS pour représenter les 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 de miniport Storport utilisent pour représenter une adresse physique ou une adresse relative de bus.

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
En-tête	storport.h (inclure Storport.h)
Bibliothèque	Storport.lib
Règles de conformité DDI	StorPortDeprecated(storport)

Voir aussi

ScsiPortValidateRange

Partager via