AcxCircuitAddConnections-Funktion (acxcircuit.h)
Die AcxCircuitAddConnections-Funktion fügt Verbindungen zu einem ACXCIRCUIT hinzu.
Syntax
NTSTATUS AcxCircuitAddConnections(
ACXCIRCUIT Circuit,
PACX_CONNECTION Connections,
ULONG ConnectionsCount
);
Parameter
Circuit
Ein vorhandenes ACXCIRCUIT-Objekt. Weitere Informationen zu ACX-Objekten finden Sie unter Zusammenfassung von ACX-Objekten.
Connections
Ein Zeiger auf eine ACX_CONNECTION Struktur , die die Pinstruktur einschließlich der Pin-IDs beschreibt.
ConnectionsCount
Die Anzahl der Verbindungen, 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.
Bemerkungen
Beispiel
Das Beispiel für die Verwendung ist unten dargestellt.
//
// Explicitly connect the circuit/elements. Note that driver doesn't
// need to perform this step when circuit/elements are connected in the
// same order as they were added to the circuit. By default ACX connects
// the elements starting from the sink circuit pin and ending with the
// source circuit pin for both render and capture devices.
//
// circuit.pin[default_sink] -> 1st element.pin[default_in]
// 1st element.pin[default_out] -> 2nd element.pin[default_in]
// 2nd element.pin[default_out] -> circuit.pin[default_source]
//
const int numElements = 2;
const int numConnections = numElements + 1;
ACXCIRCUIT Circuit;
ACX_CONNECTION connections[numConnections];
ACX_CONNECTION_INIT(&connections[0], Circuit, Elements[ElementCount - 2]);
ACX_CONNECTION_INIT(&connections[1], Elements[ElementCount - 2], Elements[ElementCount - 1]);
ACX_CONNECTION_INIT(&connections[2], Elements[ElementCount - 1], Circuit);
//
// Add the connections linking circuit to elements.
//
status = AcxCircuitAddConnections(Circuit, connections, SIZEOF_ARRAY(connections));
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 |