IDE_CHANNEL_INIT funzione di callback (irb.h)

  • Articolo

La routine del driver miniport AtaChannelInitRoutine inizializza l'interfaccia del canale del driver miniport.

Nota

I modelli di driver di porta ATA e ATA miniport possono essere modificati o non disponibili in futuro. È invece consigliabile usare i modelli di driver Storport e 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 ha avuto esito positivo. Restituisce FALSE se l'inizializzazione non è riuscita.

Commenti

Un driver miniport fornito dal fornitore che supporta l'interfaccia del canale deve implementare una routine AtaChannelInitRoutine 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 il driver miniport e il driver di porta interagiscono per inizializzare un canale:

  1. Durante la routine DriverEntry , il driver miniport chiama la routine di libreria AtaPortInitializeEx del driver di porta per avviare l'inizializzazione del controller e il driver miniport.

  2. Se il driver miniport supporta l'interfaccia del canale, la routine DriverEntry deve inizializzare il membro AtaChannelInitRoutine di IDE_CONTROLLER_INTERFACE per puntare alla routine AtaChannelInitRoutine del driver miniport.

  3. Il driver di porta chiama la routine AtaAdapterControl usando l'azione di controllo IdeStart. AtaChannelInitRoutine viene chiamato una volta per ogni NumberOfChannels specificato nella struttura ControllerConfiguration restituita dalla routine AtaAdapterControl quando AtaAdapterControl gestisce un'azione IdeStart.

Requisiti

Requisito Valore
Piattaforma di destinazione Desktop
Intestazione irb.h (includere Irb.h)

Vedi anche

AtaPortInitializeEx

IDE_CHANNEL_INTERFACE

IDE_CONTROLLER_INTERFACE