Функция 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.
Замечания
Пример
Ниже показан пример использования.
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 |