Freigeben über

AcxAudioModuleCreate-Funktion (acxelements.h)

Die AcxAudioModuleCreate-Funktion wird verwendet, um ein Audiomodul zu erstellen, das einem übergeordneten ACX-Schaltkreisobjekt zugeordnet wird.

Syntax

NTSTATUS AcxAudioModuleCreate(
  ACXOBJECT               Object,
  PWDF_OBJECT_ATTRIBUTES  Attributes,
  PACX_AUDIOMODULE_CONFIG Config,
  ACXAUDIOMODULE          *AudioModule
);

Parameter

Object

Ein WDFDEVICE-Objekt (in Summary of Framework Objects) beschrieben, das dem Schaltkreis zugeordnet wird.

Attributes

Zusätzliche Attribute, die mithilfe einer WDF_OBJECT_ATTRIBUTES-Struktur definiert wurden, die zum Festlegen verschiedener Werte verwendet wird, und um das Audiomodul dem ACX-Schaltkreisobjekt zuzuordnen.

Config

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

AudioModule

Ein Zeiger auf eine Position, die das Handle an das neue ACXMODULE-Objekt empfängt. 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_AUDIOMODULE_CALLBACKS       audioModuleCallbacks;
    ACX_AUDIOMODULE_CONFIG          audioModuleCfg;
    ACXAUDIOMODULE                  audioModuleElement;

    // Now add audio modules to the circuit
    // module 0

    ACX_AUDIOMODULE_CALLBACKS_INIT(&audioModuleCallbacks);
    audioModuleCallbacks.EvtAcxAudioModuleProcessCommand = CodecR_EvtProcessCommand0;

    ACX_AUDIOMODULE_CONFIG_INIT(&audioModuleCfg);

    audioModuleCfg.Name = &AudioModule0Id;
    audioModuleCfg.Descriptor.ClassId = AudioModule0Id;
    audioModuleCfg.Descriptor.InstanceId = AUDIOMODULE_INSTANCE_ID(0,0);
    audioModuleCfg.Descriptor.VersionMajor = AUDIOMODULE0_MAJOR;
    audioModuleCfg.Descriptor.VersionMinor = AUDIOMODULE0_MINOR;
    wcsncpy_s(audioModuleCfg.Descriptor.Name,
                ACX_AUDIOMODULE_MAX_NAME_CCH_SIZE,
                AUDIOMODULE0DESCRIPTION,
                wcslen(AUDIOMODULE0DESCRIPTION));
    audioModuleCfg.Callbacks = &audioModuleCallbacks;

    WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&attributes, CODEC_AUDIOMODULE0_CONTEXT);
    attributes.ParentObject = Circuit;

    status = AcxAudioModuleCreate(Circuit, &attributes, &audioModuleCfg, &audioModuleElement);

ACX-Anforderungen

Mindestens ACX-Version: 1.0

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

Anforderungen

Anforderung Wert
Header- acxelements.h
IRQL- PASSIVE_LEVEL

Siehe auch