EVT_ACX_FACTORY_CIRCUIT_POWER_UP Rückruffunktion (acxcircuit.h)

  • Artikel

Der EVT_ACX_FACTORY_CIRCUIT_POWER_UP Rückruf wird vom Treiber verwendet, um Funktionen im Power-up-Pfad eines ACXFACTORYCIRCUIT-Objekts hinzuzufügen.

Syntax

EVT_ACX_FACTORY_CIRCUIT_POWER_UP EvtAcxFactoryCircuitPowerUp;

NTSTATUS EvtAcxFactoryCircuitPowerUp(
  WDFDEVICE Device,
  ACXFACTORYCIRCUIT Factory,
  WDF_POWER_DEVICE_STATE PreviousState
)
{...}

Parameter

Device

Ein WDFDEVICE-Objekt (beschrieben in Zusammenfassung der Frameworkobjekte), das der ACX-Verbindung zugeordnet ist.

Factory

Das vorhandene ACXFACTORYCIRCUIT-Objekt der Circuit Factory. Weitere Informationen zu ACX-Objekten finden Sie unter Zusammenfassung von ACX-Objekten.

PreviousState

Eine WDF_POWER_DEVICE_STATE-Enumeration , die den vorherigen Energiezustand des Geräts identifiziert.

Rückgabewert

Gibt zurück STATUS_SUCCESS , wenn der Aufruf erfolgreich war. Andernfalls wird ein geeigneter Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Verwenden von NTSTATUS-Werten.

Wenn der Treiber bei diesem Rückruf fehlschlägt, markiert er ACXFACTORYCIRCUIT als ausstehendes Löschen. Das ACX-Framework schlägt beim Unterstrichen des ACX EvtDeviceD0Entry-Rückrufs nicht fehl. Dadurch können vorhandene funktionierende ACXFACTORYCIRCUITs von diesem Gerät verwendet werden, um Arbeitsaudiopfade zu erstellen.

Hinweise

Um eine EvtFactoryCircuitPowerUp-Rückruffunktion zu registrieren, muss ein Treiber AcxFactoryCircuitInitSetAcxCircuitPnpPowerCallbacks aufrufen.

Wenn der Treiber eine EvtFactoryCircuitPowerUp-Rückruffunktion für ein Gerät registriert hat, ruft das Framework die Funktion bei jedem Wechsel des Geräts in den Betriebszustand (D0) auf. Ein Gerät wechselt in den D0-Zustand, wenn eine der folgenden Aktionen auftritt:

  • Ein Gerät wird aufgezählt (weil das Gerät angeschlossen oder das System neu gestartet wurde).
  • Das System und alle seine Geräte kehren aus einem Energiesparzustand in ihren Arbeitszustand zurück.
  • Das Gerät kehrt in seinen Betriebszustand zurück, nachdem es in einen Energiesparzustand versetzt wurde, da es sich im Leerlauf befand (wenn das Gerät den Leerlauf mit niedrigem Stromverbrauch unterstützt).
  • Der Plug & Play Manager hat die Hardwareressourcen des Systems auf die Geräte des Systems umverteilt.
  • Das Framework ruft die EvtDeviceD0Entry-Rückruffunktion sofort auf, nachdem das Gerät in den Arbeitszustand (D0) wechselt und für den Treiber verfügbar ist, aber bevor die Unterbrechungen des Geräts aktiviert wurden. Der PreviousState-Parameter identifiziert den Energiezustand des Geräts, in dem sich das Gerät befand, bevor es in den D0-Zustand gelangt ist. Beim ersten Aufruf von EvtDeviceD0Entry durch das Framework wird der PreviousState-Wert WdfPowerDeviceD3Final bereitgestellt.

Diese Rückruffunktion muss alle Vorgänge ausführen, die erforderlich sind, um das Gerät vollständig betriebsbereit zu machen.

Weitere Informationen zu Treibern, die diese Rückruffunktion bereitstellen, finden Sie unter Unterstützen der PnP- und Energieverwaltung im Funktionstreiber.

Die EvtFactoryCircuitPowerUp-Rückruffunktion wird unter IRQL = PASSIVE_LEVEL aufgerufen. Sie sollten diese Rückruffunktion nicht auslagerungsfähig machen.

ACX-Anforderungen

ACX-Mindestversion: 1.0

Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.

Anforderungen

Anforderung Wert
Header acxcircuit.h
IRQL PASSIVE_LEVEL

Weitere Informationen