NtDoc

No description available.

Edit description on GitHub

Windows Driver Kit DDI reference (nf-acxdevice-acxdeviceremovecircuit)

Description

The AcxDeviceRemoveCircuit function removes the specified audio circuit from an ACX device.

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.

AcxDeviceRemoveCircuit - NtDoc