EVT_ACX_STREAMAUDIOENGINE_ASSIGN_EFFECTS_STATE callback function (acxelements.h)

The EVT_ACX_STREAMAUDIOENGINE_ASSIGN_EFFECTS_STATE callback function is implemented by the driver and is called when the local effects state is set for a stream audio engine node.

Syntax

EVT_ACX_STREAMAUDIOENGINE_ASSIGN_EFFECTS_STATE EvtAcxStreamaudioengineAssignEffectsState;

NTSTATUS EvtAcxStreamaudioengineAssignEffectsState(
  ACXSTREAMAUDIOENGINE StreamAudioEngine,
  ULONG State
)
{...}

Parameters

StreamAudioEngine

An existing, initialized, ACXSTREAMAUDIOENGINE object. For more information about ACX objects, see Summary of ACX Objects.

State

A ULONG value indicating whether local effect processing in the stream audio engine node is enabled. A nonzero value indicates that processing is enabled. A value of 0 indicates that it is disabled.

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_STREAMAUDIOENGINE_ASSIGN_EFFECTS_STATE              DspR_EvtAcxStreamAudioEngineAssignEffectsState;

NTSTATUS
DspR_EvtAcxStreamAudioEngineAssignEffectsState(
    _In_    ACXSTREAMAUDIOENGINE    StreamAudioEngine,
    _In_    ULONG                   State
)
{
    PAGED_CODE();

    PCODEC_STREAMAUDIOENGINE_CONTEXT pStreamAudioEngineCtx;
    pStreamAudioEngineCtx = GetCodecStreamAudioEngineContext(StreamAudioEngine);

    pStreamAudioEngineCtx->LFxEnabled = (BOOLEAN)State;

    return STATUS_SUCCESS;
}

ACX requirements

Minimum ACX version: 1.0

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

Requirements

See also

• acxelements.h header