AcxStreamAudioEngineCreate, fonction (acxelements.h)

  • Article

La fonction AcxStreamAudioEngineCreate permet de créer un objet moteur audio de flux ACX qui sera 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 de WDF_OBJECT_ATTRIBUTES qui sont utilisés pour définir diverses valeurs et pour associer le moteur audio de flux de flux à l’objet de flux parent.

Config

Structure 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 de l’objet ACXSTREAMAUDIOENGINE nouvellement créé. Pour plus d’informations sur les objets ACX, consultez Résumé des objets ACX.

Valeur retournée

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

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 ACX minimale : 1.0

Pour plus d’informations sur les versions d’ACX, consultez Vue d’ensemble des versions d’ACX.

Configuration requise

Condition requise Valeur
En-tête acxelements.h
IRQL PASSIVE_LEVEL

Voir aussi