Função AcxCircuitAddPins (acxcircuit.h)
A função AcxCircuitAddPins adiciona pinos a um ACXCIRCUIT.
Sintaxe
NTSTATUS AcxCircuitAddPins(
ACXCIRCUIT Circuit,
ACXPIN *Pins,
ULONG PinsCount
);
Parâmetros
Circuit
Um objeto ACXCIRCUIT existente. Para obter mais informações sobre objetos ACX, consulte Resumo de objetos ACX.
Pins
Um objeto ACXPIN existente que será adicionado ao circuito.
PinsCount
O número de pinos que serão adicionados ao circuito. Esta é uma contagem baseada em um.
Retornar valor
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.
Comentários
Um ACXCIRCUIT tem pelo menos um pin de entrada (ACXPIN) e um pin de saída (ACXPIN) e pode agregar um ou mais ACXELEMENTs.
Cada ACXCIRCUIT tem pelo menos um pino de coletor e um pino de origem. Esses pinos são usados pela estrutura ACX para expor as conexões do circuito com a pilha de áudio. Para um circuito de Renderização, o pin De origem é usado para controlar o comportamento de renderização (propriedades do dispositivo) de qualquer fluxo criado a partir do circuito. Para um circuito de Captura, o pin do coletor é usado para controlar o comportamento de captura (propriedades do dispositivo) de qualquer fluxo criado a partir do circuito.
ACXPIN é o objeto usado para controlar o streaming no Caminho de Áudio. Para topologias ACXCIRCUIT simples, o ACX poderá criar automaticamente o outro ACXPIN se apenas um estiver presente.
Exemplo
O uso de exemplo é mostrado abaixo.
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);
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 |