Compartir a través de

Función AcxStreamAudioEngineCreate (acxelements.h)

  • Artículo

La función AcxStreamAudioEngineCreate se usa para crear un objeto del motor de audio de secuencia ACX que se asociará a un objeto de secuencia ACX primario. Para obtener más información sobre los objetos ACX, vea Resumen de objetos ACX.

Sintaxis

NTSTATUS AcxStreamAudioEngineCreate(
  ACXSTREAM                     Stream,
  ACXAUDIOENGINE                AudioEngine,
  PWDF_OBJECT_ATTRIBUTES        Attributes,
  PACX_STREAMAUDIOENGINE_CONFIG Config,
  ACXSTREAMAUDIOENGINE          *StreamAudioEngine
);

Parámetros

Stream

Objeto ACXSTREAM que representa una secuencia de audio en el hardware de un circuito específico. Para obtener más información sobre los objetos ACX, vea Resumen de objetos ACX.

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.

Attributes

Atributos adicionales definidos mediante una estructura de WDF_OBJECT_ATTRIBUTES que se usan para establecer varios valores y para asociar el motor de audio de secuencia al objeto de secuencia primario.

Config

Estructura ACX_STREAMAUDIOENGINE_CONFIG inicializada que describe la configuración del motor de audio de secuencia.

StreamAudioEngine

Puntero a una ubicación que recibe el identificador del objeto ACXSTREAMAUDIOENGINE recién creado. Para obtener más información sobre los objetos ACX, vea Resumen de objetos ACX.

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.

    NTSTATUS                        status;
    WDF_OBJECT_ATTRIBUTES           attributes;
    ACXSTREAM                       stream;
    ACXELEMENT                      elements[2] = {0};
    ACX_STREAMAUDIOENGINE_CONFIG    audioEngineCfg;

        ACX_STREAMAUDIOENGINE_CONFIG_INIT(&audioEngineCfg);
        audioEngineCfg.VolumeElement = volumeElement;
        audioEngineCfg.MuteElement = muteElement;
        audioEngineCfg.PeakMeterElement = peakmeterElement;
        audioEngineCfg.Callbacks = &streamAudioEngineCallbacks;

        WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&attributes, CODEC_STREAMAUDIOENGINE_CONTEXT);
        attributes.ParentObject = stream;

        status = AcxStreamAudioEngineCreate(stream, circuitCtx->AudioEngineElement, &attributes, &audioEngineCfg, (ACXSTREAMAUDIOENGINE*)&elements[0]);

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