AcxStreamAddElements-Funktion (acxstreams.h)
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 |