StorPortInitialize, fonction (storport.h)
Le StorPortInitialize routine initialise les paramètres du pilote de port et les données d’extension. StorPortInitialize enregistre également les informations de l’adaptateur fournies à partir de la routine pilote miniportDriverEntry.
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 de 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 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 :
| Retourner le code | Description |
|---|---|
| STATUS_INVALID_PARAMETER | Argument1 a la valeur NULL ou Argument2 a la valeur 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.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| d’en-tête | storport.h (include Storport.h) |
| bibliothèque | Storport.lib |