EVT_ACX_AUDIOENGINE_ASSIGN_EFFECTS_STATE función de devolución de llamada (acxelements.h)

  • Artículo

El controlador implementa la EVT_ACX_AUDIOENGINE_ASSIGN_EFFECTS_STATE función de devolución de llamada y se llama cuando se establece el estado de efectos globales para un nodo del motor de audio. El estado de efectos globales se puede establecer en TRUE o FALSE, donde TRUE indica que el procesamiento de efectos globales en el nodo del motor de audio está habilitado y FALSE indica que el procesamiento de efectos globales en el nodo del motor de audio está deshabilitado.

Sintaxis

EVT_ACX_AUDIOENGINE_ASSIGN_EFFECTS_STATE EvtAcxAudioengineAssignEffectsState;

NTSTATUS EvtAcxAudioengineAssignEffectsState(
  ACXAUDIOENGINE AudioEngine,
  ULONG State
)
{...}

Parámetros

AudioEngine

Objeto ACXAUDIOENGINE que se usa en un circuito de representación para representar un DSP. Para obtener más información sobre los objetos ACX, vea Resumen de objetos ACX.

State

El valor state es de tipo ULONG, pero se convierte al tipo BOOLEAN en la devolución de llamada para indicar si el procesamiento de efectos globales en el nodo del motor de audio está habilitado. Un valor true indica que el procesamiento está habilitado. FALSE indica que está deshabilitado.

Valor devuelto

Devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, devuelve un código de error adecuado. Para obtener más información, vea Uso de valores NTSTATUS.

Comentarios

Ejemplo

A continuación se muestra un ejemplo de uso.

typedef struct _DSP_ENGINE_CONTEXT
{
    ACXDATAFORMAT MixFormat;
    BOOLEAN GFxEnabled;
} DSP_ENGINE_CONTEXT, *PDSP_ENGINE_CONTEXT;

WDF_DECLARE_CONTEXT_TYPE_WITH_NAME(DSP_ENGINE_CONTEXT, GetDspEngineContext)

EVT_ACX_AUDIOENGINE_ASSIGN_EFFECTS_STATE        DspR_EvtAcxAudioEngineAssignEffectsState;

NTSTATUS
DspR_EvtAcxAudioEngineAssignEffectsState(
    ACXAUDIOENGINE  AudioEngine,
    ULONG           State
)
{
    PAGED_CODE();
    
    PDSP_ENGINE_CONTEXT   pAudioEngineCtx;
    pAudioEngineCtx = GetDspEngineContext(AudioEngine);

    pAudioEngineCtx->GFxEnabled = (BOOLEAN)State;

    return STATUS_SUCCESS;
}

Requisitos de ACX

Versión mínima de ACX: 1.0

Para obtener más información sobre las versiones de ACX, consulte Introducción a la versión de ACX.

Requisitos

Requisito Valor
Header acxelements.h
IRQL PASSIVE_LEVEL

Consulte también