KSPROPERTY_AUDIO_MIX_LEVEL_TABLE
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 |
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.
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.
Requisitos
parâmetro |
Ksmedia.h (inclua Ksmedia.h) |