Funzione AcxStreamAudioEngineCreate (acxelements.h)
La funzione AcxStreamAudioEngineCreate viene usata per creare un oggetto motore audio di flusso ACX che verrà associato a un elemento padre dell'oggetto flusso ACX. Per altre informazioni sugli oggetti ACX, vedere Riepilogo degli oggetti ACX.
Sintassi
NTSTATUS AcxStreamAudioEngineCreate(
ACXSTREAM Stream,
ACXAUDIOENGINE AudioEngine,
PWDF_OBJECT_ATTRIBUTES Attributes,
PACX_STREAMAUDIOENGINE_CONFIG Config,
ACXSTREAMAUDIOENGINE *StreamAudioEngine
);
Parametri
Stream
Oggetto ACXSTREAM che rappresenta un flusso audio sull'hardware di un circuito specifico. Per altre informazioni sugli oggetti ACX, vedere Riepilogo degli oggetti ACX.
AudioEngine
Oggetto ACXAUDIOENGINE utilizzato in un circuito di rendering per rappresentare un DSP. Per altre informazioni sugli oggetti ACX, vedere Riepilogo degli oggetti ACX.
Attributes
Attributi aggiuntivi definiti usando una struttura WDF_OBJECT_ATTRIBUTES utilizzata per impostare vari valori e per associare il motore audio di flusso all'oggetto flusso padre.
Config
Struttura ACX_STREAMAUDIOENGINE_CONFIG inizializzata che descrive la configurazione del motore audio di flusso.
StreamAudioEngine
Puntatore a una posizione che riceve l'handle all'oggetto ACXSTREAMAUDIOENGINE appena creato. Per altre informazioni sugli oggetti ACX, vedere Riepilogo degli oggetti ACX.
Valore restituito
Restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un codice di errore appropriato. Per altre informazioni, vedere Uso dei valori NTSTATUS.
Commenti
Esempio
Di seguito è riportato un esempio di utilizzo.
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]);
Requisiti di ACX
Versione minima di ACX: 1.0
Per altre informazioni sulle versioni ACX, vedere La panoramica della versione di ACX.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | acxelements.h |
| IRQL | PASSIVE_LEVEL |