AtaPortInitializeEx, fonction (IRB. h)

La routine de la bibliothèque du pilote de port AtaPortInitializeEx ATA Initialise le port et les pilotes de miniport.

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

Syntaxe

ULONG AtaPortInitializeEx(
  [in] PVOID                     DriverObject,
  [in] PVOID                     RegistryPath,
  [in] PIDE_CONTROLLER_INTERFACE ControllerInterface
);

Paramètres

[in] DriverObject

Pointeur vers l’objet du pilote de miniport.

[in] RegistryPath

Contient une chaîne Unicode qui indique l’emplacement où les informations de configuration du pilote de miniport sont stockées dans le registre.

[in] ControllerInterface

Contient les points d’entrée pour les routines AtaAdapterControl, AtaChannelInitRoutine, AtaControllerChannelEnabledet AtaControllerTransferModeSelect .

Valeur de retour

AtaPortInitializeEx retourne STATUS_SUCCESS si l’opération a échoué. Sinon, elle retourne un code d’erreur.

Notes

La routine AtaPortInitializeEx initialise les structures de données de clé utilisées par le port et les pilotes de miniport. Il démarre également l’initialisation des canaux du contrôleur. La séquence suivante décrit les principales actions prises par cette routine :

  1. Dans sa routine DriverEntry , le pilote de miniport appelle la routine de bibliothèque AtaPortInitializeEx du pilote de port et lui transmet les paramètres de clé suivants :
    • ControllerInterface: contient les points d’entrée pour les routines AtaAdapterControl, AtaChannelInitRoutine, AtaControllerChannelEnabledet AtaControllerTransferModeSelect .
  2. La routine AtaPortInitializeEx initialise les structures de données de clé utilisées par le port et les pilotes de miniport et exécute les actions suivantes :
    1. Initialise les tables de dispatch du pilote de miniport.
    2. Alloue une extension pour l’objet Driver.
    3. Copie ControllerInterface dans l’extension de pilote.
    4. Une fois que AtaPortInitializeEx a terminé l’initialisation du pilote de port, il revient à la routine DriverEntry du pilote miniport.
  3. Lors du démarrage de l’adaptateur, la routine du pilote miniAtaAdapterControl sera appelée par le pilote de port avec l’action de contrôle IdeStart.
  4. Lorsque le pilote de port ATA traite une demande de démarrage de périphérique de canal, la routine de pilote de miniport AtaControllerChannelEnabled est appelée pour chaque canal sur le contrôleur afin de déterminer s’il est activé.
  5. Une fois que la routine AtaControllerChannelEnabled détermine les canaux activés, le pilote de port ATA appelle AtaChannelInitRoutine pour ce canal.

Spécifications

   
Plateforme cible Bureau
En-tête IRB. h (inclure ATA. h, IRB. h)
Bibliothèque Pciidex. lib

Voir aussi

AtaChannelInitRoutine

AtaControllerChannelEnabled

DriverEntry

IDE_CONTROLLER_CONFIGURATION