IDE_CHANNEL_INIT fonction de rappel (irb.h)

Article
02/29/2024

La routine du pilote miniport AtaChannelInitRoutine initialise l’interface de canal du pilote miniport.

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_CHANNEL_INIT IdeChannelInit;

BOOLEAN IdeChannelInit(
  PVOID ChannelExtension,
  PIDE_CHANNEL_INTERFACE ChannelInterface,
  PVOID InitContext
)
{...}

Paramètres

ChannelExtension

[in] Pointeur vers l’extension de canal de pilote miniport.

ChannelInterface

[in, out] Pointeur vers une structure de IDE_CHANNEL_INTERFACE contenant des informations d’interface pour le canal indiqué.

InitContext

[in, out] Pointeur vers l’extension du contrôleur.

Valeur retournée

AtaChannelInitRoutine retourne TRUE si l’initialisation a réussi. Il retourne FALSE si l’initialisation a échoué.

Remarques

Un pilote miniport fourni par le fournisseur qui prend en charge l’interface de canal doit implémenter une routine AtaChannelInitRoutine pour initialiser les canaux du contrôleur. En particulier, la routine AtaChannelInitRoutine doit terminer l’initialisation de la structure IDE_CHANNEL_INTERFACE . La séquence suivante décrit la façon dont le pilote miniport et le pilote de port interagissent pour initialiser un canal :

Dans sa routine DriverEntry , le pilote miniport appelle la routine de bibliothèque AtaPortInitializeEx du pilote de port pour lancer l’initialisation du contrôleur et du pilote miniport.
Si le pilote miniport prend en charge l’interface de canal, la routine DriverEntry doit initialiser le membre AtaChannelInitRoutine de IDE_CONTROLLER_INTERFACE pour pointer vers la routine AtaChannelInitRoutine du pilote miniport.
Le pilote de port appelle la routine AtaAdapterControl à l’aide de l’action de contrôle IdeStart. AtaChannelInitRoutine est appelé une fois pour chaque NumberOfChannels spécifié dans la structure ControllerConfiguration qui est retournée par la routine AtaAdapterControl quand AtaAdapterControl gère une action IdeStart .

Configuration requise

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

Voir aussi

AtaPortInitializeEx

IDE_CHANNEL_INTERFACE

IDE_CONTROLLER_INTERFACE

Partager via