AcxStreamAddElements-Funktion (acxstreams.h)

AcxStreamAddElements wird zum Hinzufügen von Streamelementen zu einem AcxStream verwendet.

Syntax

NTSTATUS AcxStreamAddElements(
  ACXSTREAM  Stream,
  ACXELEMENT *Elements,
  ULONG      ElementsCount
);

Parameter

Stream

Ein vorhandenes ACXSTREAM--Objekt. Ein ACXSTREAM -Objekt stellt einen Von einem Schaltkreis erstellten Audiodatenstrom dar. Der Datenstrom kann null oder mehr Elemente enthalten. Weitere Informationen finden Sie unter ACX – Zusammenfassung von ACX Objects.

Elements

Ein Zeiger auf ein Array eines oder mehrerer vorhandener ACXELEMENT Objects.

ElementsCount

Die Anzahl der hinzuzufügenden Elemente. Dies ist eine 1 basierte Anzahl.

Rückgabewert

Gibt STATUS_SUCCESS zurück, wenn der Anruf erfolgreich war. Andernfalls wird ein entsprechender Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Verwenden von NTSTATUS-Werten.

Bemerkungen

Beispiel

Die Beispielverwendung wird unten gezeigt.

    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-Anforderungen

Mindestens ACX-Version: 1.0

Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.

Anforderungen

Siehe auch

• acxstreams.h-Header-