EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE Rückruffunktion (acxcircuit.h)
Der EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE Rückruf wird von ACX aufgerufen, wenn der Treiber ein zuvor erstelltes WDFDEVICE löschen muss, das einem ACXCIRCUIT-Objekt zugeordnet ist.
Syntax
EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE EvtAcxFactoryCircuitDeleteCircuitdevice;
NTSTATUS EvtAcxFactoryCircuitDeleteCircuitdevice(
WDFDEVICE Parent,
ACXFACTORYCIRCUIT Factory,
WDFDEVICE Device
)
{...}
Parameter
Parent
Ein WDFDEVICE-Objekt (beschrieben in Summary of Framework Objects), das das übergeordnete Element des WDFDEVICE ist, auf das im Device-Objekt verwiesen wird.
Factory
Das vorhandene ACXFACTORYCIRCUIT-Objekt der Circuit Factory. Weitere Informationen zu ACX-Objekten finden Sie unter Zusammenfassung von ACX-Objekten.
Device
Ein WDFDEVICE-Objekt (beschrieben in Zusammenfassung der Frameworkobjekte), das gelöscht werden muss.
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.
Hinweise
Ein AcxFactoryCircuit stellt ein Factoryobjekt dar, das bei Bedarf eine ACXCIRCUIT-Instanz erstellen kann.
Ein Treiber kann einen oder mehrere ACXFACTORYCIRCUIT bei ACX registrieren. Durch diese Aktion wird ACX informiert, dass der Treiber ACXCIRCUITs eines klar definierten Typs erstellen kann.
ACX ruft die ACXFACTORYCIRCUIT-Rückrufe auf, wenn erkannt wird, dass ein Audiopfad eines der werkseitig bereitgestellten ACXCIRCUITs erfordert.
Dies ist ein optionaler Rückruf. Wenn der EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE Rückruf nicht definiert ist, führt ACX die Standardaktion aus, um den angegebenen WDFDEVICE aus der Liste der aufgezählten Geräte zu entfernen. Diese Aktion löst eine überraschend entfernte PnP-Benachrichtigung für das untergeordnete WDFDEVICE aus.
Das ACXFACTORYCIRCUIT-Objekt unterstützt dynamische ACXCIRCUITs. Dies bedeutet, dass jeder von der Factory erstellte ACXCIRCUIT einem WDFDEVICE zugeordnet ist und diese beiden Objekte dieselbe Lebensdauer haben.
Ein AcxFactoryCircuit verfügt über eine dedizierte WDF-Warteschlange. Weitere Informationen zu WDF-Warteschlangen finden Sie unter Framework-Warteschlangenobjekte.
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 |