IDE_ADAPTER_CONTROL fonction de rappel (irb.h)

Article
02/07/2025

Le AtaAdapterControl routine de pilote miniport est appelée pour effectuer des opérations Plug-and-Play (PnP) et de gestion de l’alimentation sur l’adaptateur HBA.

Note

Le pilote de port ATA et les modèles de pilotes miniport ATA peuvent être modifiés ou indisponibles à l’avenir. Au lieu de cela, nous vous recommandons d’utiliser le du pilote Storport et modèles de pilotes Storport miniport.

Syntaxe

IDE_ADAPTER_CONTROL IdeAdapterControl;

BOOLEAN IdeAdapterControl(
  [in]      PVOID ControllerExtension,
  [in]      IDE_CONTROL_ACTION ControlAction,
  [in, out] PVOID Parameters
)
{...}

Paramètres

[in] ControllerExtension

Pointeur vers l’extension du contrôleur.

[in] ControlAction

L’une des cinq actions que le pilote miniport doit effectuer comme défini dans le tableau suivant.

ControlAction	Paramètres	Description
IdeStart	IDE_CONTROLLER_CONFIGURATION	Indique que l’adaptateur est démarré. Le pilote miniport doit mettre à jour le membre dans la structure IDE_CONTROLLER_CONFIGURATION. S’il est nécessaire, le pilote miniport peut obtenir ses ressources matérielles à partir de la structure IDE_CONTROLLER_CONFIGURATION.
IdeStop	Aucun	Le pilote miniport doit cesser d’utiliser les ressources allouées pour ce contrôleur. N’oubliez pas que le pilote de port garantit que tous les canaux exposés par l’adaptateur sont arrêtés avant d’arrêter l’adaptateur.
IdePowerUp	Aucun	Indique que l’adaptateur est activé. Tout ce qui ne persiste pas dans un cycle d’alimentation doit être configuré pendant IdePowerUp.
IdePowerDown	Aucun	Indique que l’adaptateur est désactivé.
IdeVendorDefined	Aucun	Indique que le pilote miniport doit effectuer une action de contrôle définie par le fournisseur.

[in, out] Parameters

Paramètres associés à l’action donnée.

Valeur de retour

Le pilote miniport doit retourner TRUE pour confirmer l’achèvement de l’action demandée. Une valeur de retour de FALSE indique que le pilote miniport n’a pas pu terminer l’action avec succès. Une valeur de retour de FAUX pour certaines actions peut entraîner l’échec de l’installation de l’appareil.

Remarques

Le pilote de port garantit qu’il n’y a pas d’E/S en attente sur l’adaptateur avant d’appeler la routine AtaAdapterControl.

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	irb.h (include Irb.h)

Voir aussi

IDE_CONTROLLER_CONFIGURATION

Partager via