Edit

EVT_ACX_AUDIOENGINE_ASSIGN_ENGINE_FORMAT callback function (acxelements.h)

  • Article

The EVT_ACX_AUDIOENGINE_ASSIGN_ENGINE_FORMAT callback function is implemented by the driver and is called when the internal mix format is set for an audio engine node.

Syntax

EVT_ACX_AUDIOENGINE_ASSIGN_ENGINE_FORMAT EvtAcxAudioengineAssignEngineFormat;

NTSTATUS EvtAcxAudioengineAssignEngineFormat(
  ACXAUDIOENGINE AudioEngine,
  ACXDATAFORMAT Format
)
{...}

Parameters

AudioEngine

An ACXAUDIOENGINE object that is used in a render circuit to represent a DSP. For more information about ACX objects, see Summary of ACX Objects.

Format

An ACXDATAFORMAT object that describes the mix format for the specified audio engine.

Return value

Returns STATUS_SUCCESS if the call was successful. Otherwise, it returns an appropriate error code. For more information, see Using NTSTATUS Values.

Remarks

Example

Example usage is shown below.

EVT_ACX_AUDIOENGINE_ASSIGN_ENGINE_FORMAT        DspR_EvtAcxAudioEngineAssignEngineDeviceFormat;

NTSTATUS
DspR_EvtAcxAudioEngineAssignEngineDeviceFormat(
    ACXAUDIOENGINE,
    ULONG
)
{
    PAGED_CODE();
    
    // Custom Code goes here

    return STATUS_SUCCESS;
}

ACX requirements

Minimum ACX version: 1.0

For more information about ACX versions, see ACX version overview.

Requirements

Requirement Value
Header acxelements.h
IRQL PASSIVE_LEVEL

See also