IDE_CHANNEL_INIT funzione di callback (irb.h)
La routine del driver AtaChannelInitRoutine miniport inizializza l'interfaccia del canale del driver miniport.
Nota
I modelli di driver di porta ATA e miniport ATA potrebbero essere modificati o non disponibili in futuro. È invece consigliabile usare driver Storport e modelli di driver miniport Storport.
Sintassi
IDE_CHANNEL_INIT IdeChannelInit;
BOOLEAN IdeChannelInit(
PVOID ChannelExtension,
PIDE_CHANNEL_INTERFACE ChannelInterface,
PVOID InitContext
)
{...}
Parametri
ChannelExtension
[in] Puntatore all'estensione del canale del driver miniport.
ChannelInterface
[in, out] Puntatore a una struttura IDE_CHANNEL_INTERFACE contenente informazioni sull'interfaccia per il canale indicato.
InitContext
[in, out] Puntatore all'estensione del controller.
Valore restituito
AtaChannelInitRoutine restituisce TRUE se l'inizializzazione è riuscita. Restituisce FALSE se l'inizializzazione non è riuscita.
Osservazioni
Un driver miniport fornito dal fornitore che supporta l'interfaccia del canale deve implementare un AtaChannelInitRoutine routine per inizializzare i canali del controller. In particolare, la routine AtaChannelInitRoutine deve completare l'inizializzazione della struttura IDE_CHANNEL_INTERFACE. La sequenza seguente descrive come interagiscono il driver miniport e il driver della porta per inizializzare un canale:
Mentre nella routine DriverEntry, il driver miniport chiama la routine del driver di porta AtaPortInitializeEx libreria per avviare l'inizializzazione del controller e del driver miniport.
Se il driver miniport supporta l'interfaccia del canale, la routine DriverEntry deve inizializzare il AtaChannelInitRoutine membro di IDE_CONTROLLER_INTERFACE in modo che punti alla routine ataChannelInitRoutine del driver miniport.
Il driver della porta chiama la routine AtaAdapterControl usando l'azione di controllo IdeStart. AtaChannelInitRoutine viene chiamato una volta per ogni numberOfChannels specificato nella struttura ControllerConfiguration restituito dalla routine AtaAdapterControl quando AtaAdapterControl gestisce un'azione IdeStart.
Fabbisogno
Requisito | Valore |
---|---|
piattaforma di destinazione | Desktop |
intestazione | irb.h (include Irb.h) |