Функция AcxElementCreate (acxelements.h)
Функция AcxElementCreate используется для создания объекта ACXELEMENT, который будет связан с родительским объектом канала или объекта устройства потока.
Синтаксис
NTSTATUS AcxElementCreate(
ACXOBJECT Object,
PWDF_OBJECT_ATTRIBUTES Attributes,
PACX_ELEMENT_CONFIG Config,
ACXELEMENT *Element
);
Параметры
Object
Объект WDFDEVICE (описан в разделе Сводка объектов платформы), который будет связан с потоком или каналом.
Attributes
Дополнительные атрибуты, определенные с помощью структуры WDF_OBJECT_ATTRIBUTES , которые используются для задания различных значений и для связывания элемента ACX с родительским потоком или объектом цепи.
Config
Инициализированная структура ACX_ELEMENT_CONFIG , описывающая конфигурацию элемента.
Element
Указатель на расположение, которое получает дескриптор только что созданного объекта ACXELEMENT. Дополнительные сведения об объектах ACX см. в разделе Сводка по объектам ACX.
Возвращаемое значение
Возвращает значение STATUS_SUCCESS , если вызов был успешным. В противном случае возвращается соответствующий код ошибки. Дополнительные сведения см. в разделе Использование значений NTSTATUS.
Remarks
Пример
Ниже приведен пример использования.
NTSTATUS status;
WDF_OBJECT_ATTRIBUTES attributes;
ACXSTREAM stream;
ACXELEMENT elements[2] = {0};
ACX_ELEMENT_CONFIG elementCfg;
CODEC_ELEMENT_CONTEXT * elementCtx;
ACX_ELEMENT_CONFIG_INIT(&elementCfg);
WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&attributes, CODEC_ELEMENT_CONTEXT);
attributes.ParentObject = stream;
status = AcxElementCreate(stream, &attributes, &elementCfg, &elements[0]);
Требования ACX
Минимальная версия ACX: 1.0
Дополнительные сведения о версиях ACX см. в статье Обзор версий ACX.
Требования
| Требование | Значение |
|---|---|
| Заголовок | acxelements.h |
| IRQL | PASSIVE_LEVEL |