AcxAudioModuleCreate 函式 (acxelements.h)
AcxAudioModuleCreate 函式是用來建立與 ACX 線路物件父系相關聯的音訊模組。
語法
NTSTATUS AcxAudioModuleCreate(
ACXOBJECT Object,
PWDF_OBJECT_ATTRIBUTES Attributes,
PACX_AUDIOMODULE_CONFIG Config,
ACXAUDIOMODULE *AudioModule
);
參數
Object
WDFDEVICE 物件 (描述於與線路相關聯的 Framework 物件摘要) 。
Attributes
使用 WDF_OBJECT_ATTRIBUTES 結構定義的其他屬性，可用來設定各種值，並將音訊模組與 ACX 線路對象產生關聯。
Config
描述音訊模組組態的初始化 ACX_AUDIOMODULE_CONFIG結構 。
AudioModule
接收新 ACXMODULE 物件句柄之位置的指標。 如需 ACX 對象的詳細資訊，請參閱 ACX 物件的摘要。
傳回值
如果呼叫成功，則傳 STATUS_SUCCESS 回 。 否則，它會傳回適當的錯誤碼。 如需詳細資訊，請參閱 使用NTSTATUS值。
備註
範例
範例使用方式如下所示。
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 需求
最小 ACX 版本： 1.0
如需 ACX 版本的詳細資訊，請參閱 ACX 版本概觀。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 | acxelements.h |
| IRQL | PASSIVE_LEVEL |