AcxDeviceRemoveCircuit-Funktion (acxdevice.h)
Die AcxDeviceRemoveCircuit-Funktion entfernt die angegebene Audioschaltung von einem ACX-Gerät.
Syntax
NTSTATUS AcxDeviceRemoveCircuit(
WDFDEVICE Device,
ACXCIRCUIT Circuit
);
Parameter
Device
Der WDFDEVICE , aus dem die durch den Circuit-Parameter angegebene Audioschaltung entfernt werden soll.
Circuit
Die Audioschaltung, die aus dem durch den Device-Parameter angegebenen WDFDEVICE entfernt werden soll.
Rückgabewert
AcxDeviceRemoveCircuit gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich war. Andernfalls wird ein NTSTATUS-Fehlercode zurückgegeben.
Hinweise
Verwenden Sie AcxDeviceAddCircuit , um einem WDFDEVICE eine Audioschaltung hinzuzufügen.
Diese Funktion kann nur über die EVT_WDF_DEVICE_RELEASE_HARDWARE Rückruffunktion für dieses Gerät aufgerufen werden.
Beispiel
NTSTATUS status;
WDFDEVICE Device = NULL;
PUSBA2_DEVICE_CONTEXT devCtx;
// Code to initialize WDFDEVICE...
devCtx = GetDeviceContext(Device);
//
// Unregister filter and delete this audio filter.
//
if (devCtx->RenderCircuitAdded) {
ASSERT(devCtx->RenderCircuit);
status = AcxDeviceRemoveCircuit(Device, devCtx->RenderCircuit);
devCtx->RenderCircuit = NULL;
devCtx->RenderCircuitAdded = FALSE;
}
ACX-Anforderungen
ACX-Mindestversion: 1.0
Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.
Anforderungen
Anforderung | Wert |
---|---|
Header | acxdevice.h |
IRQL | PASSIVE_LEVEL |