AcxStreamAudioEngineCreate, fonction (acxelements.h)

La fonction AcxStreamAudioEngineCreate est utilisée pour créer un objet de moteur audio de flux ACX associé à un parent d’objet de flux ACX. Pour plus d’informations sur les objets ACX, consultez Résumé des objets ACX.

Syntaxe

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

Paramètres

Stream

Objet ACXSTREAM qui représente un flux audio sur le matériel d’un circuit spécifique. Pour plus d’informations sur les objets ACX, consultez Résumé des objets ACX.

AudioEngine

Objet ACXAUDIOENGINE utilisé dans un circuit de rendu pour représenter un DSP. Pour plus d’informations sur les objets ACX, consultez Résumé des objets ACX.

Attributes

Attributs supplémentaires définis à l’aide d’une structure WDF_OBJECT_ATTRIBUTES utilisée pour définir différentes valeurs et associer le moteur audio de flux à l’objet de flux parent.

Config

Structure de ACX_STREAMAUDIOENGINE_CONFIG initialisée qui décrit la configuration du moteur audio de flux.

StreamAudioEngine

Pointeur vers un emplacement qui reçoit le handle vers l’objet ACXSTREAMAUDIOENGINE nouvellement créé. Pour plus d’informations sur les objets ACX, consultez Résumé des objets ACX.

Valeur de retour

Retourne STATUS_SUCCESS si l’appel a réussi. Sinon, elle retourne un code d’erreur approprié. Pour plus d’informations, consultez Using NTSTATUS Values.

Remarques

Exemple

L’exemple d’utilisation est illustré ci-dessous.

    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]);

Configuration requise pour ACX

version minimale d’ACX : 1.0

Pour plus d’informations sur les versions ACX, consultez vue d’ensemble de la version ACX.

Exigences

Voir aussi

• en-tête acxelements.h