Share via

Função AcxStreamBridgeAddStream (acxstreams.h)

  • Artigo

A função AcxStreamBridgeAddStream adiciona um ACXSTREAM existente a um ACXSTREAMBRIDGE existente. Para obter mais informações sobre objetos ACX, consulte ACX – Resumo de objetos ACX.

Sintaxe

NTSTATUS AcxStreamBridgeAddStream(
  ACXSTREAMBRIDGE Bridge,
  ACXSTREAM       Stream
);

Parâmetros

Bridge

Um objeto ACXSTREAMBRIDGE é usado por um circuito para propagar a criação de fluxo, os estados do fluxo fazem a transição e as configurações de DRM entre os segmentos de fluxo de circuito do ponto de extremidade. Esse objeto só é usado em um cenário de vários circuitos (composição de áudio).

Stream

Um objeto ACXSTREAM representa um fluxo de áudio criado por um circuito. O fluxo é composto por uma lista de elementos criados com base nos elementos do circuito pai.

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

Os drivers chamam AcxStreamBridgeAddStream nestes cenários:

(a) os drivers desejam selecionar manualmente o ACXSTREAMBRIDGE a ser usado para o ACXSTREAM atual.

(b) os drivers (e seus requisitos de hardware) precisam dos ACXCIRCUITs de nível inferior, ou seja, os circuitos mais próximos do pino de ponte do dispositivo, para executar uma ação antes que as ACXCIRCUITs de nível superior tomem medidas.

(c) os drivers precisam executar uma ação antes e depois das ACXCIRCUITs de nível inferior.

Para um tipo AcxStreamBridgeMux, apenas um ACXSTREAM de nível inferior é criado independentemente do número de ACXSTREAMs de entrada adicionado a essa ponte. Isso significa que o ACXSTREAM de saída (que para o circuito local do fluxo é representado com um ACXTARGETSTREAM), só é criado para o primeiro ACXSTREAM adicionado ao ACXSTREAMBRIDGE. Qualquer ACXSTREAMs de entrada adicional, basta fazer uma referência a esse ACXTARGETSTREAM existente.

Para um tipo AcxSTreamBridgeMux, a saída ACXTARGETSTREAM é removida quando o último ACXSTREAM de entrada é removido do ACXSTREAMBRIDGE com AcxStreamBridgeRemoveStream.

Exemplo

O uso de exemplo é mostrado abaixo. O código de tratamento de erros não é mostrado.

        status = AcxStreamBridgeCreate(Circuit, &attributes, &bridgeCfg, &bridge);

        // Pin ID 1 is the bridge pin in this example.
        bridgePin = AcxCircuitGetPinById(Circuit, 1);
        
        status = AcxPinAddStreamBridges(bridgePin, &bridge, 1);

        status = AcxStreamBridgeAddStream(bridge, stream);

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 acxstreams.h
IRQL PASSIVE_LEVEL

Confira também