AcxDeviceAddCircuitDevice function (acxdevice.h)
The AcxDeviceAddCircuitDevice function adds an ACX circuit device to a specified parent device representing an audio path.
Syntax
NTSTATUS AcxDeviceAddCircuitDevice(
WDFDEVICE ParentDevice,
WDFDEVICE Device
);
Parameters
ParentDevice
A WDFDEVICE representing the parent to which the circuit device will be added.
Device
A WDFDEVICE representing the circuit device to add to the parent device.
Return value
AcxDeviceAddCircuitDevice returns STATUS_SUCCESS if the call was successful. Otherwise, it returns an NTSTATUS error code.
Remarks
Audio drivers use this function to enumerate a new audio endpoint.
This function can be called at any time during the driver's life cycle. Plug and Play serializes the enumeration of the device, and the associated circuits, in relation to other Plug and Play activities on the parent and siblings devices.
Example
WDFDEVICE Device;
WDFDEVICE renderDevice = NULL;
NTSTATUS status;
// Code to initialize the WDFDEVICE...
// Code to create the WDFDEVICE renderDevice...
//
// Add circuit to device's dynamic circuit device list.
//
status = AcxDeviceAddCircuitDevice(Device, renderDevice);
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 |