Edit

AcxDeviceRemoveCircuit function (acxdevice.h)

  • Article

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

See also