KSPROPERTY_AUDIO_MIX_LEVEL_TABLE

Artigo
06/15/2023

A propriedade KSPROPERTY_AUDIO_MIX_LEVEL_TABLE especifica os níveis de combinação para um nó supermixer (KSNODETYPE_SUPERMIX). Ele fornece informações para todos os canais de entrada e saída.

Tabela de Resumo de Uso

Get	Set	Destino	Tipo de descritor de propriedade	Tipo de valor da propriedade
Sim	Opcional	Pin	KSNODEPROPERTY	Matriz de estruturas de KSAUDIO_MIXLEVEL

O nó é necessário para implementar o suporte para solicitações de KSPROPERTY_TYPE_GET. No entanto, o suporte para solicitações KSPROPERTY_TYPE_SET é opcional.

O valor da propriedade (dados de operação) é uma matriz de estruturas KSAUDIO_MIXLEVEL que especifica os níveis de combinação para todos os caminhos de saída de entrada M*N em um nó supermixer com canais de entrada M e N canais de saída. A matriz contém elementos M*N:

  KSAUDIO_MIXLEVEL  MixLevel[M*N];

A tabela a seguir mostra o mapeamento de elementos de matriz para os caminhos de saída de entrada M*N do nó supermixer.

Elemento Array	Caminho do Input-Output
MixLevel[0]	Canal de entrada 0 para o canal de saída 0
MixLevel[1]	Canal de entrada 0 para o canal de saída 1
MixLevel[N-1]	Canal de entrada 0 para o canal de saída N-1
MixLevel[N]	Canal de entrada 1 para o canal de saída 0
MixLevel[N+1]	Canal de entrada 1 para o canal de saída 1
MixLevel[2N-1]	Canal de entrada 1 para o canal de saída N-1
MixLevel[M*N-1]	Canal de entrada M-1 para o canal de saída N-1

A figura a seguir ilustra o mapeamento de elementos da matriz MixLevel para caminhos de saída de entrada. O índice do elemento de matriz MixLevel que controla cada caminho de entrada-saída é mostrado em colchetes.

Diagrama ilustrando o mapeamento dos elementos da matriz MixLevel de um nó de supermixer para caminhos de saída de entrada.

Se nenhum caminho conectar o canal de entrada i ao canal de saída j, o filtro deverá definir o membro Mute do elemento de matriz MixLevel[i*N+j] como TRUE.

O tamanho da matriz de KSAUDIO_MIXLEVEL é calculado a partir da estrutura de KSAUDIO_MIXCAP_TABLE recuperada de KSPROPERTY_AUDIO_MIX_LEVEL_CAPS. Se os membros InputChannels e OutputChannels da estrutura contiverem os valores m e n, o tamanho da matriz será

M * N * sizeof(KSAUDIO_MIXLEVEL)

Valor retornado

Uma solicitação de propriedade KSPROPERTY_AUDIO_MIX_LEVEL_TABLE retorna STATUS_SUCCESS para indicar que foi concluída com êxito. Caso contrário, a solicitação retornará um erro apropriado status código.

Comentários

O filtro terá êxito em uma solicitação KSPROPERTY_AUDIO_MIX_LEVEL_TABLE set-property que especifica um valor de nível misto (Membro de nível de KSAUDIO_MIXLEVEL) que está além do intervalo do filtro, mas fixará (silenciosamente) o valor no intervalo com suporte. Em uma solicitação subsequente para obter essa propriedade, no entanto, o filtro produzirá o valor real usado.