AcxCircuitAddElements-Funktion (acxcircuit.h)

  • Artikel

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

Weitere Informationen