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

Замечания

Пример

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

    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 заголовок