Skip to content

Latest commit

 

History

History
100 lines (76 loc) · 2.5 KB

nf-acxstreams-acxstreamaddelements.md

File metadata and controls

100 lines (76 loc) · 2.5 KB
Raw
UID tech.root title ms.date targetos description prerelease req.assembly req.construct-type req.ddi-compliance req.dll req.header req.idl req.include-header req.irql req.kmdf-ver req.lib req.max-support req.namespace req.redist req.target-min-winverclnt req.target-min-winversvr req.target-type req.type-library req.umdf-ver req.unicode-ansi topic_type api_type api_location api_name f1_keywords dev_langs
NF:acxstreams.AcxStreamAddElements
audio
AcxStreamAddElements
12/16/2022
Windows
AcxStreamAddElements is used to add stream elements to an AcxStream.
false
function
acxstreams.h
PASSIVE_LEVEL
apiref
HeaderDef
acxstreams.h
AcxStreamAddElements
AcxStreamAddElements
acxstreams/AcxStreamAddElements
c++

-description

AcxStreamAddElements is used to add stream elements to an AcxStream.

-parameters

-param Stream

An existing ACXSTREAM Object. An ACXSTREAM object represents an audio stream created by a circuit. The stream can include zero or more elements. For more information, see ACX - Summary of ACX Objects.

-param Elements

A pointer to an array of one or more existing ACXELEMENT Objects.

-param ElementsCount

The count of elements to be added. This is a 1 based count.

-returns

Returns STATUS_SUCCESS if the call was successful. Otherwise, it returns an appropriate error code. For more information, see Using NTSTATUS Values.

-remarks

Example

Example usage is shown below.

    ACX_ELEMENT_CONFIG_INIT(&elementCfg);
    WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&attributes, ELEMENT_CONTEXT);
 
    attributes.ParentObject = stream;
    status = AcxElementCreate(stream, &attributes, &elementCfg, &elements[0]);
    elementCtx = GetElementContext(elements[0]);
 
    ACX_ELEMENT_CONFIG_INIT(&elementCfg);
    WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&attributes, ELEMENT_CONTEXT);
 
    attributes.ParentObject = stream;
    status = AcxElementCreate(stream, &attributes, &elementCfg, &elements[1]);
    elementCtx = GetElementContext(elements[1]);
    //
    // Add stream elements
    //
    status = AcxStreamAddElements(stream, elements, SIZEOF_ARRAY(elements));

ACX requirements

Minimum ACX version: 1.0

For more information about ACX versions, see ACX version overview.

-see-also