AcxCircuitAddElements-Funktion (acxcircuit.h)
Die AcxCircuitAddElements-Funktion fügt einem ACXCIRCUIT Elemente hinzu.
Syntax
NTSTATUS AcxCircuitAddElements(
ACXCIRCUIT Circuit,
ACXELEMENT *Elements,
ULONG ElementsCount
);
Parameter
Circuit
Ein vorhandenes ACXCIRCUIT-Objekt. Weitere Informationen zu ACX-Objekten finden Sie unter Zusammenfassung der ACX-Objekte.
Elements
Mindestens ein ACXELEMENT-Objekt, das der Verbindung hinzugefügt wird.
ElementsCount
Die Anzahl der Elemente, die der Verbindung hinzugefügt werden. Dies ist eine einsbasierte Anzahl.
Rückgabewert
Gibt zurück STATUS_SUCCESS , wenn der Aufruf erfolgreich war. Andernfalls wird ein entsprechender Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Verwenden von NTSTATUS-Werten.
Hinweise
Der Treiber kann nur Elemente zu einer Verbindung hinzufügen, bevor die Leitung dem Gerät hinzugefügt wird. Der Treiber kann die Elemente der Leitung zur Laufzeit nicht ändern.
Beispiel
Die Verwendungsbeispiele finden Sie unten.
//
// Add a second element.
//
ACX_ELEMENT_CONFIG_INIT(&elementCfg);
WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&attributes, CODEC_ELEMENT_CONTEXT);
attributes.ParentObject = circuit;
status = AcxElementCreate(circuit, &attributes, &elementCfg, &elements[1]);
//
// Add the elements to the circuit.
//
status = AcxCircuitAddElements(circuit, 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 | acxcircuit.h |
| IRQL | PASSIVE_LEVEL |