AcxStreamAddElements-Funktion (acxstreams.h)

  • Artikel

AcxStreamAddElements wird verwendet, um Streamelemente zu einem AcxStream hinzuzufügen.

Syntax

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

Parameter

Stream

Ein vorhandenes ACXSTREAM-Objekt . Ein ACXSTREAM-Objekt stellt einen audiostream dar, der von einer Verbindung erstellt wird. Der Stream kann null oder mehr Elemente enthalten. Weitere Informationen finden Sie unter ACX – Zusammenfassung von ACX-Objekten.

Elements

Ein Zeiger auf ein Array von mindestens einem vorhandenen ACXELEMENT-Objekt .

ElementsCount

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

Rückgabewert

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

Bemerkungen

Beispiel

Das Beispiel für die Verwendung ist unten dargestellt.


    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

ACX-Mindestversion: 1.0

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

Anforderungen

Anforderung Wert
Header acxstreams.h
IRQL PASSIVE_LEVEL

Weitere Informationen