Compartir a través de

Función AcxStreamAudioEngineCreate (acxelements.h)

La función AcxStreamAudioEngineCreate se usa para crear un objeto de 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 con el objeto de flujo primario.

Config

Estructura de 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 Using NTSTATUS Values.

Observaciones

Ejemplo

A continuación se muestra el uso de ejemplo.

    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
encabezado de acxelements.h
irQL PASSIVE_LEVEL

Consulte también