通过

AcxAudioModuleCreate 函数 (acxelements.h)

  • 项目

AcxAudioModuleCreate 函数用于创建将与 ACX 线路对象父级关联的音频模块。

语法

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

参数

Object

将与线路关联的 框架对象) 摘要中所述的 WDFDEVICE 对象 (。

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 版本概述。

要求

要求 值
Header acxelements.h
IRQL PASSIVE_LEVEL

另请参阅