Share via

Função AcxStreamBridgeCreate (acxstreams.h)

  • Artigo

A função AcxStreamBridgeCreate usa um ACX_STREAM_BRIDGE_CONFIG para criar um StreamBridge para um circuito.

Um ACXSTREAMBRIDGE é usado por um circuito para propagar uma criação de fluxo, transições de estados do fluxo e 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).

Sintaxe

NTSTATUS AcxStreamBridgeCreate(
  ACXCIRCUIT                AcxCircuit,
  PWDF_OBJECT_ATTRIBUTES    Attributes,
  PACX_STREAM_BRIDGE_CONFIG Config,
  ACXSTREAMBRIDGE           *StreamBridge
);

Parâmetros

AcxCircuit

Um ponteiro para um local que recebe um identificador para o objeto ACXCIRCUIT associado. Para obter mais informações sobre objetos ACX, consulte ACX – Resumo de objetos ACX.

Attributes

Atributos adicionais definidos usando um WDF_OBJECT_ATTRIBUTES que são usados para definir os valores de vários objetos: limpar e destruir retornos de chamada, tipo de contexto e especificar seu objeto pai. Para obter mais informações, consulte WDF_OBJECT_ATTRIBUTES estrutura e a seção de comentários deste tópico.

Config

Uma estrutura ACX_STREAM_BRIDGE_CONFIG que define a configuração.

StreamBridge

Um ponteiro para um local que recebe um identificador para o novo objeto ACXSTREAMBRIDGE.

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 ponto de extremidade de áudio é uma coleção de um ou mais circuitos de áudio (objetos ACXCIRCUIT) que são montados para criar um caminho de áudio completo. Um driver ACX normalmente cria circuitos de áudio para diferentes pontos de extremidade de áudio, embora o ACX não proíba que circuitos criados pelo mesmo driver façam parte da coleção do mesmo ponto de extremidade de áudio, desde que pertençam a uma pilha de dispositivos diferente. Um ponto de extremidade de áudio é uma coleção de circuitos de áudio criados pelos mesmos drivers de áudio ou diferentes.

Por padrão, o pai do novo objeto ACXSTREAMBRIDGE é o ACXCIRCUIT especificado. Você pode usar o membro ParentObject da estrutura WDF_OBJECT_ATTRIBUTES para especificar um pai diferente com ACXCIRCUIT como ancestral. A estrutura exclui o objeto ACXSTREAMBRIDGE quando exclui o objeto pai.

O driver pode excluir o objeto ACXSTREAMBRIDGE quando terminar de usar o objeto ; caso contrário, o objeto permanecerá até que o pai seja excluído, que é o caso quando ele é criado durante a inicialização/criação do ACXCIRCUIT.

Um pino pode ser associado a zero, um ou mais ACXSTREAMBRIDGEs. O ACX pesquisa a lista de modo de processamento de sinal do ACXPIN associado para uma correspondência do modo de processamento de sinal de fluxo. A pesquisa é interrompida na primeira correspondência.

O ACX cria um ACXSTREAMBRIDGE padrão para uma ponte ACXCIRCUIT para ACXCIRCUIT se o driver não criar um, e o driver não desabilitou a manipulação de ponte de fluxo padrão com a função AcxCircuitInitDisableDefaultStreamBridgeHandling.

Exemplo

O uso de exemplo é mostrado abaixo.

    ACX_STREAM_BRIDGE_CONFIG bridgeCfg;
    ACXSTREAMBRIDGE          bridge = NULL;
    
    ACX_STREAM_BRIDGE_CONFIG_INIT(&bridgeCfg);
    bridgeCfg.InModesCount = 1;
    bridgeCfg.InModes      = inModes; 
    bridgeCfg.OutMode      = &AUDIO_SIGNALPROCESSINGMODE_DEFAULT;

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

Requisitos do ACX

Versão mínima do ACX: 1.0

Para obter mais informações sobre as 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