通过

AcxElementCreate 函数 （acxelements.h）

  • 项目

AcxElementCreate 函数用于创建将与线路或流式传输设备对象父对象关联的 ACXELEMENT 对象。

语法

NTSTATUS AcxElementCreate(
  ACXOBJECT              Object,
  PWDF_OBJECT_ATTRIBUTES Attributes,
  PACX_ELEMENT_CONFIG    Config,
  ACXELEMENT             *Element
);

参数

Object

将与流或线路关联的 WDFDEVICE 对象（Framework 对象摘要中所述）。

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

另请参阅