IDE_ADAPTER_CONTROL função de retorno de chamada (irb.h)
O AtaAdapterControl rotina de driver de miniporto é chamado para executar operações plug and play (PnP) e Power Management no HBA.
Nota
O driver de porta do ATA e os modelos de driver de miniporto do ATA podem estar alterados ou indisponíveis no futuro. Em vez disso, recomendamos usar o de driver do Storport e miniporto storport modelos de driver.
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 miniporto 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 de IDE_CONTROLLER_CONFIGURATION. |
| IdeStop | Nenhum | O driver de miniporto 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.
Valor de retorno
O driver de miniporto deve retornar verdadeiro para reconhecer a conclusão da ação solicitada. Um valor retornado de FALSE indica que o driver de miniporto não pôde concluir a ação com êxito. Um valor retornado de FALSE para determinadas ações pode causar falha na instalação do dispositivo.
Observações
O driver de porta garante que não há nenhuma E/S pendente no adaptador antes de invocar a rotina de AtaAdapterControl.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | irb.h (inclua Irb.h) |