通过

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 版本概述。

要求

要求 值
Header acxelements.h
IRQL PASSIVE_LEVEL

另请参阅