IDE_ADAPTER_CONTROL funzione di callback (irb.h)

  • Articolo

La routine del driver miniport AtaAdapterControl viene chiamata per eseguire operazioni di Plug and Play (PnP) e risparmio energia nell'HBA.

Nota

I modelli di driver di porta ATA e miniport ATA potrebbero essere modificati o non disponibili in futuro. È invece consigliabile usare il driver Storport e i modelli di driver miniport Storport .

Sintassi

IDE_ADAPTER_CONTROL IdeAdapterControl;

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

Parametri

[in] ControllerExtension

Puntatore all'estensione del controller.

[in] ControlAction

Una delle cinque azioni che il driver miniport deve eseguire come definito nella tabella seguente.

ControlAction Parametri Descrizione
IdeStart IDE_CONTROLLER_CONFIGURATION Indica che l'adattatore è in corso di avvio. Il driver miniport deve aggiornare il membro nella struttura IDE_CONTROLLER_CONFIGURATION . Se necessario, il driver miniport potrebbe ottenere le risorse hardware dalla struttura IDE_CONTROLLER_CONFIGURATION .
IdeStop Nessuno Il driver miniport deve interrompere l'uso di tutte le risorse allocate per questo controller. Tenere presente che il driver della porta garantisce che tutti i canali esposti dalla scheda vengano arrestati prima di arrestare l'adattatore.
IdePowerUp Nessuno Indica che l'adattatore è attivato. Qualsiasi elemento che non persiste in un ciclo di alimentazione deve essere configurato durante IdePowerUp.
IdePowerDown Nessuno Indica che l'adattatore è in corso di disattivazione.
IdeVendorDefined Nessuno Indica che il driver miniport deve eseguire un'azione di controllo definita dal fornitore.

[in, out] Parameters

Parametri associati all'azione specificata.

Valore restituito

Il driver miniport deve restituire TRUE per confermare il completamento dell'azione richiesta. Un valore restituito FALSE indica che il driver miniport non è riuscito a completare correttamente l'azione. Un valore restituito false per determinate azioni potrebbe causare l'esito negativo dell'installazione del dispositivo.

Commenti

Il driver di porta garantisce che non vi siano operazioni di I/O in sospeso sull'adattatore prima di richiamare la routine AtaAdapterControl .

Requisiti

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

Vedi anche

IDE_CONTROLLER_CONFIGURATION