Função AcxStreamBridgeCreate (acxstreams.h)
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 |