Fonction ScsiPortInitialize (srb.h)

Article
02/26/2024

Pour un pilote miniport non Plug-and-Play, la routine ScsiPortInitialize configure la structure PORT_CONFIGURATION_INFORMATION et appelle la routine HwScsiFindAdapter du pilote miniport. ScsiPortInitialize configure également des objets et des ressources système pour le compte de pilotes miniports. Pour un pilote miniport Plug-and-Play, ScsiPortInitialize stocke les données d’initialisation du pilote miniport pour une utilisation ultérieure.

Note Les modèles de pilote de port SCSI et de pilote miniport SCSI peuvent être modifiés ou indisponibles à l’avenir. Au lieu de cela, nous vous recommandons d’utiliser les modèles de pilote Storport et de pilote Miniport Storport .

Syntaxe

SCSIPORT_API ULONG ScsiPortInitialize(
  [in] PVOID                   Argument1,
  [in] PVOID                   Argument2,
  [in] _HW_INITIALIZATION_DATA *HwInitializationData,
  [in] PVOID                   HwContext
);

Paramètres

[in] Argument1

Pointeur vers l’objet pilote que le système d’exploitation a passé au pilote miniport dans le premier argument de sa routine DriverEntry .

[in] Argument2

Pointeur vers certaines informations de contexte que le système d’exploitation a transmises au pilote miniport dans le deuxième argument de son DriverEntry.

[in] HwInitializationData

Pointeur vers les informations d’initialisation et de configuration fournies par DriverEntry.

[in] HwContext

Spécifie l’adresse d’une valeur de contexte à passer à la routine HwScsiFindAdapter du pilote miniport. Seuls les pilotes miniport hérités qui analysent le bus à la recherche de HBA plutôt que de recevoir des informations de configuration du pilote de port peuvent utiliser ce paramètre pour stocker l’état entre les appels à HwScsiFindAdapter.

Valeur retournée

ScsiPortInitialize retourne une valeur status qui est utilisée comme valeur de retour de la routine DriverEntry du pilote miniport.

Remarques

La routine DriverEntry de chaque pilote miniport doit appeler ScsiPortInitialize une fois que le pilote miniport a d’abord zéro, puis configuré le HW_INITIALIZATION_DATA.

Si un pilote miniport peut prendre en charge des HBA sur différents types de bus d’E/S, tels que les bus d’E/S de type Isa et MicroChannel , le pilote miniport doit appeler ScsiPortInitialize pour chaque type d’interface pris en charge.

Un pilote miniport qui appelle ScsiPortInitialize plusieurs fois doit case activée la valeur retournée par ScsiPortInitialize à chaque appel et enregistrer la valeur la plus faible pour tous ses appels. La routine DriverEntry doit retourner la valeur la plus faible lorsqu’elle retourne le contrôle au système. Les enregistreurs de pilotes miniport ne peuvent faire aucune hypothèse concernant les valeurs retournées par ScsiPortInitialize.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	srb.h (inclure Miniport.h, Scsi.h)
Bibliothèque	Scsiport.lib

Voir aussi

DriverEntry de SCSI Miniport Driver

HW_INITIALIZATION_DATA (SCSI)

HwScsiFindAdapter

Partager via