AcxDeviceRemoveFactoryCircuit-Funktion (acxdevice.h)
Die funktion AcxDeviceRemoveFactoryCircuit entfernt einen Werkskreis zum Erstellen von Audioschaltungen aus einem WDFDEVICE-.
Syntax
NTSTATUS AcxDeviceRemoveFactoryCircuit(
WDFDEVICE Device,
ACXFACTORYCIRCUIT Factory
);
Parameter
Device
Die WDFDEVICE-, aus dem der ACX-Werkskreis entfernt wird.
Factory
Der ACX-Werkskreis, der aus dem WDFDEVICE- entfernt werden soll, der durch den Parameter Device angegeben wird.
Rückgabewert
AcxDeviceRemoveFactoryCircuit gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich war. Andernfalls wird ein NTSTATUS Fehlercode zurückgegeben.
Bemerkungen
Ein typischer Treiber muss nicht AcxDeviceRemoveFactoryCircuit-aufrufen. Diese Funktion sollte nicht aufgerufen werden, wenn der Werkskreis Schaltkreisgeräte erstellt hat, die noch aktiv sind.
Wenn sich ein Treiber entscheidet, diese Funktion für einen Werkskreis aufzurufen, wird der Treiber für das erste Entfernen der Schaltungsgeräte verantwortlich, die über den zugeordneten Werkskreis erstellt wurden, bevorAcxDeviceRemoveFactoryCircuit aufgerufen wird.
Weitere Informationen zum Arbeiten mit Schaltkreisen finden Sie unter dynamische Entfernung und ACX-Geräteenumeration.
Diese Funktion kann nur von der EVT_WDF_DEVICE_RELEASE_HARDWARE Rückruffunktion für dieses Gerät aufgerufen werden.
Verwenden Sie AcxDeviceAddFactoryCircuit-, um einem WDFDEVICE-einen Werkskreis hinzuzufügen.
ACX-Anforderungen
Mindestens ACX-Version: 1.0
Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | acxdevice.h |
| IRQL- | PASSIVE_LEVEL |