Compartir a través de

Función AcxAudioEngineCreate (acxelements.h)

  • Artículo

La función AcxAudioEngineCreate se usa para crear un motor de audio que se asociará a un circuito WDFDEVICE objeto de dispositivo primario.

Sintaxis

NTSTATUS AcxAudioEngineCreate(
  ACXCIRCUIT              Object,
  PWDF_OBJECT_ATTRIBUTES  Attributes,
  PACX_AUDIOENGINE_CONFIG Config,
  ACXAUDIOENGINE          *AudioEngine
);

Parámetros

Object

Objeto WDFDEVICE (descrito en Resumen de objetos de marco) que se asociará al circuito.

Attributes

Estructura WDF_OBJECT_ATTRIBUTES que se usa para asociar AcxAudioEngine con el objeto de circuito primario. Tenga en cuenta que los atributos de WDF adicionales, como WDF_EXECUTION_LEVEL o WDF_SYNCHRONIZATION_SCOPE, no deben establecerse con el parámetro Attributes, ya que son administrados por ACX.

Config

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

AudioEngine

Puntero a una ubicación que recibe el identificador del nuevo 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.

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.

    NTSTATUS                        status;
    WDF_OBJECT_ATTRIBUTES           attributes;
    ACX_AUDIOENGINE_CONFIG          audioEngineCfg;

    ACX_AUDIOENGINE_CONFIG_INIT(&audioEngineCfg);

    audioEngineCfg.HostPin = Pins[HostPin];
    audioEngineCfg.OffloadPin = Pins[OffloadPin];
    audioEngineCfg.LoopbackPin = Pins[LoopbackPin];
    audioEngineCfg.VolumeElement = volumeElement;
    audioEngineCfg.MuteElement = muteElement;
    audioEngineCfg.PeakMeterElement = peakmeterElement;
    audioEngineCfg.Callbacks = &audioEngineCallbacks;

    WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&attributes, CODEC_ENGINE_CONTEXT);
    attributes.ParentObject = Circuit;

    status = AcxAudioEngineCreate(Circuit, &attributes, &audioEngineCfg, AudioEngine);

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