Fonction StorPortInitialize (storport.h)

  • Article

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 à passer à la routine HwStorFindAdapter 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 à HwStorFindAdapter.

Valeur retournée

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 status suivants :

Code de retour Description
STATUS_INVALID_PARAMETER Argument1 a la valeur NULL, ou Argument2 est NULL, OU HwInitializationData a la valeur NULL.
STATUS_SUCCESS Les données d’extension du pilote et les informations de 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 de pilote.

Remarques

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

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

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

Configuration requise

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

Voir aussi

HW_INITIALIZATION_DATA

HwStorFindAdapter