AcxAudioEngineCreate-Funktion (acxelements.h)
Die AcxAudioEngineCreate-Funktion wird verwendet, um eine Audio-Engine zu erstellen, die einem übergeordneten WDFDEVICE-Geräteobjekt der Leitung zugeordnet wird.
Syntax
NTSTATUS AcxAudioEngineCreate(
ACXCIRCUIT Object,
PWDF_OBJECT_ATTRIBUTES Attributes,
PACX_AUDIOENGINE_CONFIG Config,
ACXAUDIOENGINE *AudioEngine
);
Parameter
Object
Ein WDFDEVICE-Objekt (beschrieben in Zusammenfassung der Frameworkobjekte), das der Verbindung zugeordnet wird.
Attributes
Eine WDF_OBJECT_ATTRIBUTES-Struktur , die verwendet wird, um die AcxAudioEngine dem übergeordneten Leitungsobjekt zuzuordnen. Beachten Sie, dass zusätzliche WDF-Attribute wie WDF_EXECUTION_LEVEL oder WDF_SYNCHRONIZATION_SCOPE nicht mithilfe des Parameters Attributes festgelegt werden sollten, da sie von ACX verwaltet werden.
Config
Eine initialisierte ACX_AUDIOENGINE_CONFIG Struktur , die die Konfiguration der Audio-Engine beschreibt.
AudioEngine
Ein Zeiger auf eine Position, die das Handle auf das neue ACXAUDIOENGINE-Objekt empfängt, das in einer Renderleitung verwendet wird, um einen DSP darzustellen. 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;
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);
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 |