AcxStreamAudioEngineCreate-Funktion (acxelements.h)
Die AcxStreamAudioEngineCreate-Funktion wird verwendet, um ein ACX-Stream-Audio-Engine-Objekt zu erstellen, das einem übergeordneten ACX-Streamobjekt zugeordnet wird. Weitere Informationen zu ACX-Objekten finden Sie unter Zusammenfassung der ACX-Objekte.
Syntax
NTSTATUS AcxStreamAudioEngineCreate(
ACXSTREAM Stream,
ACXAUDIOENGINE AudioEngine,
PWDF_OBJECT_ATTRIBUTES Attributes,
PACX_STREAMAUDIOENGINE_CONFIG Config,
ACXSTREAMAUDIOENGINE *StreamAudioEngine
);
Parameter
Stream
Ein ACXSTREAM-Objekt, das einen Audiostream auf der Hardware einer bestimmten Leitung darstellt. Weitere Informationen zu ACX-Objekten finden Sie unter Zusammenfassung der ACX-Objekte.
AudioEngine
Ein ACXAUDIOENGINE-Objekt, das in einer Renderleitung verwendet wird, um einen DSP darzustellen. Weitere Informationen zu ACX-Objekten finden Sie unter Zusammenfassung der ACX-Objekte.
Attributes
Zusätzliche Attribute, die mithilfe einer WDF_OBJECT_ATTRIBUTES-Struktur definiert werden, die zum Festlegen verschiedener Werte und zum Zuordnen der Streamaudio-Engine zum übergeordneten Streamobjekt verwendet werden.
Config
Eine initialisierte ACX_STREAMAUDIOENGINE_CONFIG-Struktur , die die Konfiguration der Streamaudio-Engine beschreibt.
StreamAudioEngine
Ein Zeiger auf eine Position, die das Handle auf das neu erstellte ACXSTREAMAUDIOENGINE-Objekt empfängt. Weitere Informationen zu ACX-Objekten finden Sie unter Zusammenfassung der ACX-Objekte.
Rückgabewert
Gibt zurück STATUS_SUCCESS , wenn der Aufruf erfolgreich war. Andernfalls wird ein entsprechender Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Verwenden von NTSTATUS-Werten.
Bemerkungen
Beispiel
Die Verwendungsbeispiele finden Sie unten.
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]);
ACX-Anforderungen
AcX-Mindestversion: 1.0
Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | acxelements.h |
| IRQL | PASSIVE_LEVEL |