IDE_ADAPTER_CONTROL funzione di callback (irb.h)
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) |