AcxAudioModuleCreate-Funktion (acxelements.h)
Die AcxAudioModuleCreate-Funktion wird verwendet, um ein Audiomodul zu erstellen, das einem übergeordneten ACX-Leitungsobjekt zugeordnet wird.
Syntax
NTSTATUS AcxAudioModuleCreate(
ACXOBJECT Object,
PWDF_OBJECT_ATTRIBUTES Attributes,
PACX_AUDIOMODULE_CONFIG Config,
ACXAUDIOMODULE *AudioModule
);
Parameter
Object
Ein WDFDEVICE-Objekt (beschrieben in Zusammenfassung der Frameworkobjekte), das der Verbindung zugeordnet wird.
Attributes
Zusätzliche Attribute, die mithilfe einer WDF_OBJECT_ATTRIBUTES-Struktur definiert werden, die zum Festlegen verschiedener Werte und zum Zuordnen des Audiomoduls mit dem ACX-Leitungsobjekt verwendet werden.
Config
Eine initialisierte ACX_AUDIOMODULE_CONFIG Struktur , die die Konfiguration des Audiomoduls beschreibt.
AudioModule
Ein Zeiger auf eine Position, die das Handle zum neuen ACXMODULE-Objekt empfängt. Weitere Informationen zu ACX-Objekten finden Sie unter Zusammenfassung von ACX-Objekten.
Rückgabewert
Gibt zurück STATUS_SUCCESS , wenn der Aufruf erfolgreich war. Andernfalls wird ein geeigneter Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Verwenden von NTSTATUS-Werten.
Bemerkungen
Beispiel
Das Beispiel für die Verwendung ist unten dargestellt.
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
ACX-Mindestversion: 1.0
Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | acxelements.h |
| IRQL | PASSIVE_LEVEL |