Compartilhar via

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

  • Artigo

A rotina do driver de miniporto AtaAdapterControl é chamada para executar operações de PnP (Plug and Play) e Gerenciamento de Energia no HBA.

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_ADAPTER_CONTROL IdeAdapterControl;

BOOLEAN IdeAdapterControl(
  [in]      PVOID ControllerExtension,
  [in]      IDE_CONTROL_ACTION ControlAction,
  [in, out] PVOID Parameters
)
{...}

Parâmetros

[in] ControllerExtension

Um ponteiro para a extensão do controlador.

[in] ControlAction

Uma das cinco ações que o driver de miniporto deve executar conforme definido na tabela a seguir.

ControlAction Parâmetros Descrição
IdeStart IDE_CONTROLLER_CONFIGURATION Indica que o adaptador está sendo iniciado. O driver de miniporte deve atualizar o membro na estrutura IDE_CONTROLLER_CONFIGURATION . Se for necessário, o driver de miniporto poderá obter seus recursos de hardware da estrutura IDE_CONTROLLER_CONFIGURATION .
IdeStop Nenhum O driver de miniporte deve parar de usar todos os recursos alocados para esse controlador. Lembre-se de que o driver de porta garante que todos os canais expostos pelo adaptador sejam interrompidos antes que ele pare o adaptador.
IdePowerUp Nenhum Indica que o adaptador está sendo ativado. Qualquer coisa que não persista em um ciclo de energia deve ser configurada durante o IdePowerUp.
IdePowerDown Nenhum Indica que o adaptador está sendo desativado.
IdeVendorDefined Nenhum Indica que o driver de miniporto deve executar uma ação de controle definida pelo fornecedor.

[in, out] Parameters

Parâmetros associados à ação fornecida.

Retornar valor

O driver de miniporte deve retornar TRUE para reconhecer a conclusão da ação solicitada. Um valor retornado de FALSE indica que o driver de miniporte não pôde concluir a ação com êxito. Um valor retornado de FALSE para determinadas ações pode fazer com que a instalação do dispositivo falhe.

Comentários

O driver de porta garante que não haja E/S pendente no adaptador antes de invocar a rotina AtaAdapterControl .

Requisitos

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

Confira também

IDE_CONTROLLER_CONFIGURATION