IDE_ADAPTER_CONTROL Rückruffunktion (irb.h)
Die AtaAdapterControl-Miniporttreiberroutine wird aufgerufen, um Plug & Play -Vorgänge (PnP) und Energieverwaltung für den HBA auszuführen.
Hinweis
Die Modelle ATA-Porttreiber und ATA-Miniporttreiber können in Zukunft geändert oder nicht mehr verfügbar sein. Stattdessen wird empfohlen, die Modelle Storport-Treiber und Storport-Miniporttreiber zu verwenden.
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 ausführen muss, wie in der folgenden Tabelle definiert.
| ControlAction | Parameter | BESCHREIBUNG |
|---|---|---|
| IdeStart | IDE_CONTROLLER_CONFIGURATION | Gibt an, dass der Adapter gestartet wird. Der Miniporttreiber sollte den Member in der IDE_CONTROLLER_CONFIGURATION-Struktur aktualisieren. Wenn dies erforderlich ist, kann der Miniporttreiber seine Hardwareressourcen aus der IDE_CONTROLLER_CONFIGURATION-Struktur abrufen. |
| IdeStop | Keine | Der Miniporttreiber sollte die Verwendung aller Ressourcen beenden, die für diesen Controller zugewiesen sind. Beachten Sie, dass der Porttreiber garantiert, dass alle Kanäle, die vom Adapter verfügbar gemacht werden, beendet werden, bevor er den Adapter beendet. |
| IdePowerUp | Keine | Gibt an, dass der Adapter aktiviert ist. Alles, was nicht während eines Energiezyklus beibehalten wird, muss während IdePowerUp konfiguriert werden. |
| IdePowerDown | Keine | Gibt an, dass der Adapter deaktiviert ist. |
| IdeVendorDefined | Keine | 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. Der Rückgabewert 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.
Hinweise
Der Porttreiber garantiert, dass keine ausstehenden E/A-Vorgänge auf dem Adapter vorhanden sind, bevor er die AtaAdapterControl-Routine aufruft.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | irb.h (include Irb.h) |