StorPortInitialize, fonction (storport.h)

La routine StorPortInitialize initialise les paramètres du pilote de port et les données d’extension. StorPortInitialize enregistre également les informations d’adaptateur fournies à partir de la routine DriverEntry du pilote miniport.

Syntaxe

STORPORT_API ULONG StorPortInitialize(
  [in]           PVOID                   Argument1,
  [in]           PVOID                   Argument2,
  [in]           _HW_INITIALIZATION_DATA *HwInitializationData,
  [in, optional] PVOID                   HwContext
);

Paramètres

[in] Argument1

Premier pointeur avec lequel le système d’exploitation a appelé la routine DriverEntry du miniport.

[in] Argument2

Deuxième pointeur avec lequel le système d’exploitation a appelé la routine DriverEntry des miniports.

[in] HwInitializationData

Pointeur vers les informations d’initialisation et de configuration définies par le pilote miniport dans sa routine DriverEntry.

[in, optional] HwContext

Adresse d’une valeur de contexte à transmettre à la routine HwStorFindAdapter 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 à HwStorFindAdapter.

Valeur de retour

Résultat des actions d’initialisation effectuées par StorPortInitialize. Le pilote miniport retourne cette valeur comme valeur de retour pour sa routine DriverEntry.

StorPortInitialize retourne l’un des codes d’état suivants :

Code de retour Description
STATUS_INVALID_PARAMETER Argument1 est NULL, ou Argument2 est NULL, OR HwInitializationData a la valeur NULL.
STATUS_SUCCESS Les données d’extension de pilote et les informations sur l’adaptateur ont été initialisées avec succès.
STATUS_NO_MEMORY Aucune mémoire n’est disponible pour stocker un paramètre d’initialisation.
STATUS_REVISION_MISMATCH La version de la structure pointée par HwInitializationData n’est pas valide pour le système d’exploitation actuel.
STATUS_INSUFFICENT_RESOURCES L’allocation a échoué pour les données d’extension d’objet du pilote.

Remarques

Cette routine doit être appelée à partir de la routine DriverEntry du pilote miniport.

Étant donné que les pilotes miniport Storport doivent prendre en charge PnP, le pilote Storport n’utilise pas le paramètre HwContext passé à StorPortInitialize.

Chaque routine DriverEntry du pilote miniport doit appeler StorPortInitialize une fois que le pilote miniport a d’abord zéro, puis définir les membres de HW_INITIALIZATION_DATA.

Spécifications

   
Plateforme cible Universal
En-tête storport.h (inclure Storport.h)
Bibliothèque Storport.lib

Voir aussi

HW_INITIALIZATION_DATA

HwStorFindAdapter