IDE_CHANNEL_INIT fonction de rappel (irb.h)
Le AtaChannelInitRoutine routine de pilote miniport initialise l’interface de canal du pilote miniport.
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_CHANNEL_INIT IdeChannelInit;
BOOLEAN IdeChannelInit(
PVOID ChannelExtension,
PIDE_CHANNEL_INTERFACE ChannelInterface,
PVOID InitContext
)
{...}
Paramètres
ChannelExtension
[in] Pointeur vers l’extension de canal du pilote miniport.
ChannelInterface
[in, out] Pointeur vers une structure IDE_CHANNEL_INTERFACE contenant des informations d’interface pour le canal indiqué.
InitContext
[in, out] Pointeur vers l’extension du contrôleur.
Valeur de retour
AtaChannelInitRoutine retourne TRUE si l’initialisation a réussi. Elle 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 un AtaChannelInitRoutine routine 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 comment 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 la routine AtaChannelInitRoutine membre de IDE_CONTROLLER_INTERFACE pour pointer vers la routine du pilote miniport AtaChannelInitRoutine.
Le pilote de port appelle la routine AtaAdapterControl à l’aide de l’action de contrôle IdeStart. AtaChannelInitRoutine est appelée une fois pour chaque NumberOfChannels spécifié dans la structure ControllerConfiguration retournée par la routine AtaAdapterControl lorsque AtaAdapterControl gère une action ideStart .
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | irb.h (include Irb.h) |