共用方式為

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

另請參閱