AcxAudioModuleCreate, fonction (acxelements.h)
La fonction AcxAudioModuleCreate permet de créer un module audio qui sera associé à un parent d’objet de circuit ACX.
Syntaxe
NTSTATUS AcxAudioModuleCreate(
ACXOBJECT Object,
PWDF_OBJECT_ATTRIBUTES Attributes,
PACX_AUDIOMODULE_CONFIG Config,
ACXAUDIOMODULE *AudioModule
);
Paramètres
Object
Objet WDFDEVICE (décrit dans Summary of Framework Objects) qui sera associé au circuit.
Attributes
Attributs supplémentaires définis à l’aide d’une structure de WDF_OBJECT_ATTRIBUTES utilisées pour définir diverses valeurs et associer le module audio à l’objet de circuit ACX.
Config
Structure ACX_AUDIOMODULE_CONFIG initialisée qui décrit la configuration du module audio.
AudioModule
Pointeur vers un emplacement qui reçoit le handle vers le nouvel objet ACXMODULE. Pour plus d’informations sur les objets ACX, consultez Résumé des objets ACX.
Valeur retournée
Retourne STATUS_SUCCESS si l’appel a réussi. Sinon, elle retourne un code d’erreur approprié. Pour plus d’informations, consultez Utilisation de valeurs NTSTATUS.
Remarques
Exemple
L’exemple d’utilisation est illustré ci-dessous.
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);
Configuration requise pour ACX
Version ACX minimale : 1.0
Pour plus d’informations sur les versions d’ACX, consultez Vue d’ensemble des versions d’ACX.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | acxelements.h |
| IRQL | PASSIVE_LEVEL |