Condividi tramite


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:

  1. 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.

  2. 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.

  3. 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)

Vedere anche

AtaPortInitializeEx

IDE_CHANNEL_INTERFACE

IDE_CONTROLLER_INTERFACE