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

См. также раздел