Edit

AcxDeviceDetachCircuit function (acxdevice.h)

  • Article

The AcxDeviceDetachCircuit function detaches an audio circuit from a WDFDEVICE prior to removal.

Syntax

NTSTATUS AcxDeviceDetachCircuit(
  WDFDEVICE  Device,
  ACXCIRCUIT Circuit
);

Parameters

Device

The WDFDEVICE from which to detach the audio circuit specified by the Circuit parameter.

Circuit

The audio circuit to remove from the WDFDEVICE specified by the Device parameter.

Return value

AcxDeviceDetachCircuit returns STATUS_SUCCESS if the call was successful. Otherwise, it returns an NTSTATUS error code.

This function can only be called from the EVT_WDF_DEVICE_RELEASE_HARDWARE callback function for this device.

AcxDeviceDetachCircuit detaches the circuit from the device. The caller is responsible for deleting the ACXCIRCUIT object.

Remarks

Example

WDFDEVICE                    Device;
NTSTATUS                     status;
PCODEC_RENDER_DEVICE_CONTEXT renderDevCtx = NULL;

// Code to initialize WDFDEVICE...

renderDevCtx = GetRenderDeviceContext(Device);

ASSERT(renderDevCtx->Circuit);
status = AcxDeviceDetachCircuit(Device, renderDevCtx->Circuit);

if (!NT_SUCCESS(status))
{
    ASSERT(FALSE);
    goto exit;
}

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