IDE_ADAPTER_CONTROL Rückruffunktion (irb.h)
Die AtaAdapterControl Miniporttreiberroutine wird aufgerufen, um Plug and Play (PnP) und Power Management-Vorgänge auf der HBA auszuführen.
Anmerkung
Der ATA-Porttreiber und die ATA Miniport-Treibermodelle können in Zukunft geändert oder nicht verfügbar sein. Stattdessen empfehlen wir die Verwendung des Storport-Treibers und Storport Miniport Treibermodelle.
Syntax
IDE_ADAPTER_CONTROL IdeAdapterControl;
BOOLEAN IdeAdapterControl(
[in] PVOID ControllerExtension,
[in] IDE_CONTROL_ACTION ControlAction,
[in, out] PVOID Parameters
)
{...}
Parameter
[in] ControllerExtension
Ein Zeiger auf die Controllererweiterung.
[in] ControlAction
Eine von fünf Aktionen, die der Miniporttreiber gemäß der Definition in der folgenden Tabelle ausführen muss.
| ControlAction | Parameter | Beschreibung |
|---|---|---|
| IdeStart | IDE_CONTROLLER_CONFIGURATION | Gibt an, dass der Adapter gestartet wird. Der Miniporttreiber sollte das Element in der IDE_CONTROLLER_CONFIGURATION Struktur aktualisieren. Wenn dies erforderlich ist, kann der Miniporttreiber seine Hardwareressourcen aus der IDE_CONTROLLER_CONFIGURATION-Struktur abrufen. |
| IdeStop | Nichts | Der Miniporttreiber sollte die Verwendung aller Ressourcen beenden, die für diesen Controller zugeordnet sind. Beachten Sie, dass der Porttreiber garantiert, dass alle Kanäle, die vom Adapter verfügbar gemacht werden, beendet werden, bevor der Adapter angehalten wird. |
| IdePowerUp | Nichts | Gibt an, dass der Adapter eingeschaltet ist. Alle Elemente, die nicht über einen Stromzyklus hinweg bestehen, müssen während IdePowerUp konfiguriert werden. |
| IdePowerDown | Nichts | Gibt an, dass der Adapter deaktiviert wird. |
| IdeVendorDefined | Nichts | Gibt an, dass der Miniporttreiber eine vom Hersteller definierte Steuerungsaktion ausführen soll. |
[in, out] Parameters
Parameter, die der angegebenen Aktion zugeordnet sind.
Rückgabewert
Der Miniporttreiber muss TRUE- zurückgeben, um den Abschluss der angeforderten Aktion zu bestätigen. Ein Rückgabewert von FALSE gibt an, dass der Miniporttreiber die Aktion nicht erfolgreich abschließen konnte. Ein Rückgabewert von FALSE- für bestimmte Aktionen kann dazu führen, dass die Geräteinstallation fehlschlägt.
Bemerkungen
Der Porttreiber garantiert, dass auf dem Adapter keine ausstehenden E/A-Vorgänge vorhanden sind, bevor die AtaAdapterControl Routine aufgerufen wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | irb.h (include Irb.h) |