AcxCircuitAddPins-Funktion (acxcircuit.h)

Die AcxCircuitAddPins-Funktion fügt einer ACXCIRCUIT-Funktion Pins hinzu.

Syntax

NTSTATUS AcxCircuitAddPins(
  ACXCIRCUIT Circuit,
  ACXPIN     *Pins,
  ULONG      PinsCount
);

Parameter

Circuit

Ein vorhandenes ACXCIRCUIT-Objekt. Weitere Informationen zu ACX-Objekten finden Sie unter Zusammenfassung von ACX-Objekten.

Pins

Ein vorhandenes ACXPIN-Objekt, das der Verbindung hinzugefügt wird.

PinsCount

Die Anzahl der Pins, 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 geeigneter Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Verwenden von NTSTATUS-Werten.

Hinweise

Ein ACXCIRCUIT verfügt mindestens über einen Eingangspin (ACXPIN) und einen Ausgangspin (ACXPIN) und kann ein oder mehrere ACXELEMENTs aggregieren.

Jeder ACXCIRCUIT verfügt über mindestens einen Senken-Pin und einen Source-Pin. Diese Pins werden vom ACX-Framework verwendet, um die Verbindungen der Verbindung mit dem Audiostapel verfügbar zu machen. Bei einer Renderschaltung wird der Quell-Pin verwendet, um das Renderverhalten (Geräteeigenschaften) eines beliebigen Datenstroms zu steuern, der aus der Verbindung erstellt wird. Bei einer Aufzeichnungsschaltung wird der Senken-Pin verwendet, um das Aufzeichnungsverhalten (Geräteeigenschaften) eines beliebigen Datenstroms zu steuern, der aus der Leitung erstellt wird.

ACXPIN ist das Objekt, das zum Steuern des Streamings im Audiopfad verwendet wird. Für einfache ACXCIRCUIT-Topologien ist ACX in der Lage, die andere ACXPIN automatisch zu erstellen, wenn nur eine vorhanden ist.

Beispiel

Das Beispiel für die Verwendung ist unten dargestellt.

    ACXPIN pin;  
 
    WDF_OBJECT_ATTRIBUTES_INIT(&attributes);
    attributes.ParentObject = circuit;

    status = AcxPinCreate(circuit, &attributes, &pinCfg, &(pin[1]));
  
    // Add the supported formats to the Default mode for the circuit
    //
    formatList = AcxPinGetRawDataFormatList(pin[1]);
  
    status = AcxDataFormatListAddDataFormat(formatList, formatPcm16000c1);
  
    //
    // Add the default streaming pin, using default pin id.
    //
    status = AcxCircuitAddPins(circuit, &(pin[1]), 1);

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