AcxStreamAudioEngineCreate-Funktion (acxelements.h)

  • Artikel

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

Weitere Informationen