AcxStreamAddElements function (acxstreams.h)
AcxStreamAddElements is used to add stream elements to an AcxStream.
Syntax
NTSTATUS AcxStreamAddElements(
ACXSTREAM Stream,
ACXELEMENT *Elements,
ULONG ElementsCount
);
Parameters
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.
Elements
A pointer to an array of one or more existing ACXELEMENT Objects.
ElementsCount
The count of elements to be added. This is a 1 based count.
Return value
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.
Requirements
Requirement | Value |
---|---|
Header | acxstreams.h |
IRQL | PASSIVE_LEVEL |