IDE_CHANNEL_INIT função de retorno de chamada (irb.h)

  • Artigo

A rotina do driver de miniporto AtaChannelInitRoutine inicializa a interface de canal do driver de miniport.

Observação

Os modelos de driver de porta do ATA e do driver de miniporto do ATA podem ser alterados ou indisponíveis no futuro. Em vez disso, recomendamos usar os modelos de driver do Storport e do driver de miniporto storport .

Sintaxe

IDE_CHANNEL_INIT IdeChannelInit;

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

Parâmetros

ChannelExtension

[in] Um ponteiro para a extensão de canal do driver de miniport.

ChannelInterface

[in, out] Ponteiro para uma estrutura IDE_CHANNEL_INTERFACE que contém informações de interface para o canal indicado.

InitContext

[in, out] Um ponteiro para a extensão do controlador.

Retornar valor

AtaChannelInitRoutine retornará TRUE se a inicialização for bem-sucedida. Ele retornará FALSE se a inicialização falhar.

Comentários

Um driver de miniporto fornecido pelo fornecedor que dá suporte à interface de canal deve implementar uma rotina AtaChannelInitRoutine para inicializar os canais do controlador. Em particular, a rotina AtaChannelInitRoutine deve concluir a inicialização da estrutura IDE_CHANNEL_INTERFACE . A sequência a seguir descreve como o driver de miniporto e o driver de porta interagem para inicializar um canal:

  1. Em sua rotina driverEntry , o driver de miniporto chama a rotina de biblioteca AtaPortInitializeEx do driver de porta para iniciar a inicialização do controlador e do driver de miniport.

  2. Se o driver de miniporto der suporte à interface de canal, a rotina DriverEntry deverá inicializar o membro AtaChannelInitRoutine do IDE_CONTROLLER_INTERFACE para apontar para a rotina AtaChannelInitRoutine do driver de miniport.

  3. O driver de porta chama a rotina AtaAdapterControl usando a ação de controle IdeStart. AtaChannelInitRoutine é chamado uma vez para cada NumberOfChannels especificado na estrutura ControllerConfiguration retornada pela rotina AtaAdapterControl quando AtaAdapterControl manipula uma ação IdeStart .

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho irb.h (inclua Irb.h)

Confira também

AtaPortInitializeEx

IDE_CHANNEL_INTERFACE

IDE_CONTROLLER_INTERFACE