Função AcxCircuitAddConnections (acxcircuit.h)
A função AcxCircuitAddConnections adiciona conexões a um ACXCIRCUIT.
Sintaxe
NTSTATUS AcxCircuitAddConnections(
ACXCIRCUIT Circuit,
PACX_CONNECTION Connections,
ULONG ConnectionsCount
);
Parâmetros
Circuit
Um objeto ACXCIRCUIT existente. Para obter mais informações sobre objetos ACX, consulte Resumo de objetos ACX.
Connections
Um ponteiro para uma estrutura ACX_CONNECTION que descreve a estrutura do pino, incluindo as IDs do pino.
ConnectionsCount
O número de conexões que serão adicionadas ao circuito. Esta é uma contagem baseada em um.
Valor de retorno
Retorna STATUS_SUCCESS se a chamada foi bem-sucedida. Caso contrário, ele retornará um código de erro apropriado. Para obter mais informações, consulte Usando valores NTSTATUS.
Observações
Exemplo
O uso de exemplo é mostrado abaixo.
//
// 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));
Requisitos do ACX
versão mínima do ACX: 1.0
Para obter mais informações sobre versões do ACX, consulte visão geral da versão do ACX.
Requisitos
| Requisito | Valor |
|---|---|
| cabeçalho | acxcircuit.h |
| IRQL | PASSIVE_LEVEL |