IDE_ADAPTER_CONTROL fonction de rappel (irb.h)

Article
02/26/2024

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

Notes

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

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 en cours de démarrage. Le pilote miniport doit mettre à jour le membre dans la structure IDE_CONTROLLER_CONFIGURATION . Si nécessaire, le pilote miniport peut obtenir ses ressources matérielles à partir de la structure IDE_CONTROLLER_CONFIGURATION .
IdeStop	None	Le pilote miniport doit cesser d’utiliser toutes 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	None	Indique que l’adaptateur est activé. Tout ce qui ne persiste pas pendant un cycle d’alimentation doit être configuré pendant IdePowerUp.
IdePowerDown	None	Indique que l’adaptateur est désactivé.
IdeVendorDefined	None	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 retournée

Le pilote miniport doit retourner TRUE pour accuser réception de l’exécution de l’action demandée. La valeur de retour FALSE indique que le pilote miniport n’a pas pu effectuer correctement l’action. Une valeur de retour FALSE 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 .

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	irb.h (include Irb.h)

Voir aussi

IDE_CONTROLLER_CONFIGURATION

Partager via