Функция AcxVolumeCreate (acxelements.h)

  • Статья

Функция AcxVolumeCreate используется для создания объекта тома ACX, который будет связан с родительским объектом канала.

Синтаксис

NTSTATUS AcxVolumeCreate(
  ACXOBJECT              Object,
  PWDF_OBJECT_ATTRIBUTES Attributes,
  PACX_VOLUME_CONFIG     Config,
  ACXVOLUME              *Volume
);

Параметры

Object

Объект WDFDEVICE (описан в разделе Сводка объектов платформы), который будет связан с каналом.

Attributes

Дополнительные атрибуты, определенные с помощью структуры WDF_OBJECT_ATTRIBUTES , которая используется для задания различных значений и для связывания объекта тома с родительским объектом цепи.

Config

Инициализированная структура ACX_VOLUME_CONFIG , описывающая конфигурацию объекта тома.

Volume

Указатель на расположение, которое получает дескриптор созданного объекта ACXVOLUME. Дополнительные сведения об объектах ACX см. в разделе Сводка по объектам ACX.

Возвращаемое значение

Возвращает значение STATUS_SUCCESS , если вызов был выполнен успешно. В противном случае возвращается соответствующий код ошибки. Дополнительные сведения см. в разделе Использование значений NTSTATUS.

Remarks

Пример

Ниже приведен пример использования.

    NTSTATUS                        status;
    WDF_OBJECT_ATTRIBUTES           attributes;

    ACX_VOLUME_CALLBACKS            volumeCallbacks;
    ACX_VOLUME_CONFIG               volumeCfg;
    CODEC_VOLUME_ELEMENT_CONTEXT *  volumeCtx;

    ACX_VOLUME_CONFIG_INIT(&volumeCfg);

    volumeCfg.ChannelsCount = MAX_CHANNELS;
    volumeCfg.Minimum = VOLUME_LEVEL_MINIMUM;
    volumeCfg.Maximum = VOLUME_LEVEL_MAXIMUM;
    volumeCfg.SteppingDelta = VOLUME_STEPPING;
    volumeCfg.Callbacks = &volumeCallbacks;

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

    status = AcxVolumeCreate(Circuit, &attributes, &volumeCfg, Element);

Требования к ACX

Минимальная версия ACX: 1.0

Дополнительные сведения о версиях ACX см. в статье Обзор версий ACX.

Требования

Требование Значение
Заголовок acxelements.h
IRQL PASSIVE_LEVEL

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