AcxDeviceRemoveCircuit function (acxdevice.h)
The AcxDeviceRemoveCircuit function removes the specified audio circuit from an ACX device.
Syntax
NTSTATUS AcxDeviceRemoveCircuit(
WDFDEVICE Device,
ACXCIRCUIT Circuit
);
Parameters
Device
The WDFDEVICE from which to remove the audio circuit specified by the Circuit parameter.
Circuit
The audio circuit to remove from the WDFDEVICE specified by the Device parameter.
Return value
AcxDeviceRemoveCircuit returns STATUS_SUCCESS if the call was successful. Otherwise, it returns an NTSTATUS error code.
Remarks
Use AcxDeviceAddCircuit to add an audio circuit to a WDFDEVICE.
This function can only be called from the EVT_WDF_DEVICE_RELEASE_HARDWARE callback function for this device.
Example
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 requirements
Minimum ACX version: 1.0
For more information about ACX versions, see ACX version overview.
Requirements
| Requirement | Value |
|---|---|
| Header | acxdevice.h |
| IRQL | PASSIVE_LEVEL |