AcxAudioEngineCreate-Funktion (acxelements.h)

Die AcxAudioEngineCreate-Funktion wird verwendet, um ein Audiomodul zu erstellen, das einem übergeordneten WDFDEVICE-Geräteobjekt 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 von Framework-Objekten), das dem Schaltkreis zugeordnet wird.

Attributes

Eine WDF_OBJECT_ATTRIBUTES Struktur, die verwendet wird, um acxAudioEngine dem übergeordneten Schaltkreisobjekt zuzuordnen. Beachten Sie, dass zusätzliche WDF-Attribute wie WDF_EXECUTION_LEVEL oder WDF_SYNCHRONIZATION_SCOPE nicht mit dem parameter Attributes festgelegt werden sollten, da sie von ACX verwaltet werden.

Config

Eine initialisierte ACX_AUDIOENGINE_CONFIG Struktur, die die Konfiguration des Audiomoduls beschreibt.

AudioEngine

Ein Zeiger auf eine Position, die das Handle auf das neue ACXAUDIOENGINE-Objekt empfängt, das in einer Renderschaltung verwendet wird, um einen DSP darzustellen. Weitere Informationen zu ACX-Objekten finden Sie unter Summary of ACX Objects.

Rückgabewert

Gibt STATUS_SUCCESS zurück, wenn der Anruf erfolgreich war. Andernfalls wird ein entsprechender Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Verwenden von NTSTATUS-Werten.

Bemerkungen

Beispiel

Die Beispielverwendung wird unten gezeigt.

    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

Mindestens ACX-Version: 1.0

Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.

Anforderungen

Siehe auch

• acxelements.h-Header