AcxPeakMeterCreate 函数 (acxelements.h)

AcxPeakMeterCreate 函数用于创建将与线路对象父级关联的 ACX 峰值计对象。

语法

NTSTATUS AcxPeakMeterCreate(
  ACXOBJECT              Object,
  PWDF_OBJECT_ATTRIBUTES Attributes,
  PACX_PEAKMETER_CONFIG  Config,
  ACXPEAKMETER           *PeakMeter
);

参数

Object

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

Attributes

使用 WDF_OBJECT_ATTRIBUTES 结构定义的其他属性，用于设置各种值并将峰值计对象与父线路对象相关联。

Config

描述音频级别峰值仪配置的初始化 ACX_PEAKMETER_CONFIG结构 。

PeakMeter

指向接收新创建的 ACXPEAKMETER 对象的句柄的位置的指针。 有关 ACX 对象的详细信息，请参阅 ACX 对象的摘要。

返回值

STATUS_SUCCESS如果调用成功，则返回 。 否则，它将返回相应的错误代码。 有关详细信息，请参阅 使用 NTSTATUS 值。

备注

示例

示例用法如下所示。

    WDF_OBJECT_ATTRIBUTES           attributes;

    ACX_PEAKMETER_CALLBACKS         peakmeterCallbacks;
    ACX_PEAKMETER_CONFIG            peakmeterCfg;
    ACXPEAKMETER                    peakmeterElement;
    CODEC_PEAKMETER_ELEMENT_CONTEXT*peakmeterCtx;

    ACX_PEAKMETER_CALLBACKS_INIT(&peakmeterCallbacks);
    peakmeterCallbacks.EvtAcxPeakMeterRetrieveLevel = CodecR_EvtPeakMeterRetrieveLevelCallback;

    ACX_PEAKMETER_CONFIG_INIT(&peakmeterCfg);
    peakmeterCfg.ChannelsCount = MAX_CHANNELS;
    peakmeterCfg.Minimum = PEAKMETER_MINIMUM;
    peakmeterCfg.Maximum = PEAKMETER_MAXIMUM;
    peakmeterCfg.SteppingDelta = PEAKMETER_STEPPING_DELTA;
    peakmeterCfg.Callbacks = &peakmeterCallbacks;

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

    status = AcxPeakMeterCreate(Circuit, &attributes, &peakmeterCfg, &peakmeterElement);

ACX 要求

最低 ACX 版本： 1.0

有关 ACX 版本的详细信息，请参阅 ACX 版本概述。

要求

另请参阅

• acxelements.h 标头