Share via

Função AcxCircuitAddPins (acxcircuit.h)

  • Artigo

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

Confira também