Функция 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 |
| IRQL | PASSIVE_LEVEL |