IDE_ADAPTER_CONTROL funzione di callback (irb.h)

Articolo
02/07/2025

La routine del driver AtaAdapterControl miniport viene chiamata per eseguire operazioni 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 driver Storport e 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'adapter è 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 di porta garantisce che tutti i canali esposti dalla scheda vengano arrestati prima di arrestare l'adattatore.
IdePowerUp	Nessuno	Indica che l'adattatore è attivato. Tutto ciò 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 di FALSE indica che il driver miniport non è riuscito a completare correttamente l'azione. Un valore restituito di false per determinate azioni potrebbe causare l'esito negativo dell'installazione del dispositivo.

Osservazioni

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

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	irb.h (include Irb.h)

Vedere anche

IDE_CONTROLLER_CONFIGURATION

Condividi tramite