Функция AcxMuteCreate (acxelements.h)
Функция AcxMuteCreate используется для создания объекта звука ACX, который будет связан с родительским объектом цепи.
Синтаксис
NTSTATUS AcxMuteCreate(
ACXOBJECT Object,
PWDF_OBJECT_ATTRIBUTES Attributes,
PACX_MUTE_CONFIG Config,
ACXMUTE *Mute
);
Параметры
Object
Объект WDFDEVICE (описан в разделе Сводка объектов платформы), который будет связан с каналом.
Attributes
Дополнительные атрибуты, определенные с помощью структуры WDF_OBJECT_ATTRIBUTES , которая используется для задания различных значений и для связывания объекта отключения звука с родительским объектом цепи.
Config
Инициализированная структура ACX_MUTE_CONFIG , описывающая конфигурацию режима отключения звука.
Mute
Указатель на расположение, которое получает дескриптор созданного объекта ACXMUTE. Дополнительные сведения об объектах ACX см. в разделе Сводка по объектам ACX.
Возвращаемое значение
Возвращает значение STATUS_SUCCESS , если вызов был выполнен успешно. В противном случае возвращается соответствующий код ошибки. Дополнительные сведения см. в разделе Использование значений NTSTATUS.
Remarks
Пример
Ниже приведен пример использования.
NTSTATUS status;
WDF_OBJECT_ATTRIBUTES attributes;
ACX_MUTE_CALLBACKS muteCallbacks;
ACX_MUTE_CONFIG muteCfg;
ACXMUTE muteElement;
ACX_MUTE_CALLBACKS_INIT(&muteCallbacks);
muteCallbacks.EvtAcxMuteAssignState = CodecR_EvtMuteAssignState;
muteCallbacks.EvtAcxMuteRetrieveState = CodecR_EvtMuteRetrieveState;
ACX_MUTE_CONFIG_INIT(&muteCfg);
muteCfg.ChannelsCount = MAX_CHANNELS;
muteCfg.Name = &KSAUDFNAME_WAVE_MUTE;
muteCfg.Callbacks = &muteCallbacks;
WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&attributes, CODEC_MUTE_ELEMENT_CONTEXT);
attributes.ParentObject = Circuit;
status = AcxMuteCreate(Circuit, &attributes, &muteCfg, &muteElement);
Требования к ACX
Минимальная версия ACX: 1.0
Дополнительные сведения о версиях ACX см. в статье Обзор версий ACX.
Требования
| Требование | Значение |
|---|---|
| Заголовок | acxelements.h |
| IRQL | PASSIVE_LEVEL |