Condividi tramite

Funzione AcxCircuitAddConnections (acxcircuit.h)

  • Articolo

La funzione AcxCircuitAddConnections aggiunge connessioni a un ACXCIRCUIT.

Sintassi

NTSTATUS AcxCircuitAddConnections(
  ACXCIRCUIT      Circuit,
  PACX_CONNECTION Connections,
  ULONG           ConnectionsCount
);

Parametri

Circuit

Oggetto ACXCIRCUIT esistente. Per altre informazioni sugli oggetti ACX, vedere Riepilogo degli oggetti ACX.

Connections

Puntatore a una struttura ACX_CONNECTION che descrive la struttura del pin, inclusi gli ID pin.

ConnectionsCount

Numero di connessioni che verranno aggiunte al circuito. Si tratta di un conteggio basato su uno.

Valore restituito

Restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un codice di errore appropriato. Per altre informazioni, vedere Uso dei valori NTSTATUS.

Commenti

Esempio

Di seguito è riportato un esempio di utilizzo.

    //
    // 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));

Requisiti di ACX

Versione minima di ACX: 1.0

Per altre informazioni sulle versioni ACX, vedere La panoramica della versione di ACX.

Requisiti

Requisito Valore
Intestazione acxcircuit.h
IRQL PASSIVE_LEVEL

Vedi anche