AtaPortInitializeEx, fonction (irb.h)

Article
02/07/2025

Le AtaPortInitializeEx routine de bibliothèque de pilotes de port ATA initialise les pilotes port et miniport.

Remarque 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

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

Paramètres

[in] DriverObject

Pointeur vers l’objet pilote miniport.

[in] RegistryPath

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

[in] ControllerInterface

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

Valeur de retour

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

Remarques

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

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