Примечание
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Функция 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 |
IRQL | PASSIVE_LEVEL |