Fonction ScsiPortInitialize (srb.h)

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 système et des ressources pour le compte des pilotes miniport. Pour un pilote miniport Plug-and-Play, ScsiPortInitialize stocke les données d’initialisation du pilote miniport pour une utilisation ultérieure.

Note Le pilote de port SCSI et les modèles de pilotes miniport SCSI peuvent être modifiés ou indisponibles à l’avenir. Au lieu de cela, nous vous recommandons d’utiliser le pilote Storport et les modèles de pilotes 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 passées 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 pour les 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 de retour

ScsiPortInitialize retourne une valeur d’état utilisée comme valeur de retour de la routine DriverEntry du pilote miniport.

Remarques

Chaque routine DriverEntry du pilote miniport doit appeler ScsiPortInitialize une fois que le pilote miniport a d’abord zéro, puis configurer le HW_INITIALIZATION_DATA.

Si un pilote miniport peut prendre en charge des HBA sur différents types d’autobus 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 vérifier la valeur retournée par ScsiPortInitialize à chaque appel et enregistrer la valeur la plus basse pour tous ses appels. La routine DriverEntry doit retourner la valeur la plus basse lorsqu’elle retourne le contrôle au système. Les enregistreurs de pilotes Miniport ne peuvent faire aucune hypothèse sur les valeurs retournées par ScsiPortInitialize.

Spécifications

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

Voir aussi

DriverEntry of SCSI Miniport Driver

HW_INITIALIZATION_DATA (SCSI)

HwScsiFindAdapter