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

  • Artículo

El controlador implementa la función de devolución de llamada EVT_ACX_AUDIOENGINE_RETRIEVE_EFFECTS_STATE y se llama cuando se solicita el estado de efectos globales para el nodo del motor de audio especificado.

Sintaxis

EVT_ACX_AUDIOENGINE_RETRIEVE_EFFECTS_STATE EvtAcxAudioengineRetrieveEffectsState;

NTSTATUS EvtAcxAudioengineRetrieveEffectsState(
  ACXAUDIOENGINE AudioEngine,
  PULONG State
)
{...}

Parámetros

AudioEngine

Objeto ACXAUDIOENGINE para el que se ha solicitado el estado de efectos globales. Para obtener más información sobre los objetos ACX, vea Resumen de objetos ACX.

State

Valor ULONG que indica el estado de efectos globales del nodo del motor de audio especificado. Un valor distinto de cero indica que el procesamiento de efectos globales en el nodo del motor de audio está habilitado y un valor de 0 indica que el procesamiento de efectos globales en el nodo del motor de audio 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 el uso de ejemplo.

typedef struct _CODEC_ENGINE_CONTEXT {
    ACXDATAFORMAT   MixFormat;
    BOOLEAN         GFxEnabled;
} CODEC_ENGINE_CONTEXT, *PCODEC_ENGINE_CONTEXT;

WDF_DECLARE_CONTEXT_TYPE_WITH_NAME(CODEC_ENGINE_CONTEXT, GetCodecEngineContext)

EVT_ACX_AUDIOENGINE_RETRIEVE_EFFECTS_STATE      Codec_EvtAcxAudioEngineRetrieveEffectsState;

NTSTATUS
Codec_EvtAcxAudioEngineRetrieveEffectsState(
    _In_    ACXAUDIOENGINE  AudioEngine,
    _Out_   PULONG          State
)
{
    PAGED_CODE();

    PCODEC_ENGINE_CONTEXT   pAudioEngineCtx;
    pAudioEngineCtx = GetCodecEngineContext(AudioEngine);

    *State = pAudioEngineCtx->GFxEnabled;

    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