KSPROPERTY_AUDIO_MIX_LEVEL_TABLE

아티클
11/14/2023

KSPROPERTY_AUDIO_MIX_LEVEL_TABLE 속성은 슈퍼믹서 노드(KSNODETYPE_SUPERMIX)의 혼합 수준을 지정합니다. 모든 입력 및 출력 채널에 대한 정보를 제공합니다.

사용량 요약 테이블

Get	Set	대상	속성 설명자 형식	속성 값 형식
예	선택 사항	Pin	KSNODEPROPERTY	KSAUDIO_MIXLEVEL 구조체의 배열

노드는 KSPROPERTY_TYPE_GET 요청에 대한 지원을 구현하는 데 필요합니다. 그러나 KSPROPERTY_TYPE_SET 요청에 대한 지원은 선택 사항입니다.

속성 값(작업 데이터)은 M 입력 채널 및 N 출력 채널이 있는 슈퍼믹서 노드의 모든 M*N 입력 출력 경로에 대한 혼합 수준을 지정하는 KSAUDIO_MIXLEVEL 구조의 배열입니다. 배열에는 M*N 요소가 포함됩니다.

  KSAUDIO_MIXLEVEL  MixLevel[M*N];

다음 표에서는 배열 요소를 슈퍼믹서 노드의 M*N 입력 출력 경로에 매핑하는 방법을 보여 줍니다.

Array 요소	Input-Output 경로
MixLevel[0]	입력 채널 0에서 출력 채널 0으로
MixLevel[1]	입력 채널 0에서 출력 채널 1로
MixLevel[N-1]	출력 채널 N-1에 대한 입력 채널 0
MixLevel[N]	출력 채널 0에 대한 입력 채널 1
MixLevel[N+1]	출력 채널 1에 대한 입력 채널 1
MixLevel[2N-1]	출력 채널 N-1에 대한 입력 채널 1
MixLevel[M*N-1]	출력 채널 N-1에 대한 입력 채널 M-1

다음 그림에서는 MixLevel 배열 요소를 입력 출력 경로에 매핑하는 방법을 보여 줍니다. 각 입력 출력 경로를 제어하는 MixLevel 배열 요소의 인덱스는 대괄호로 표시됩니다.

슈퍼믹서 노드의 MixLevel 배열 요소를 입력 출력 경로에 매핑하는 방법을 보여 주는 다이어그램

입력 채널 i를 출력 채널 j에 연결하는 경로가 없는 경우 필터는 배열 요소 MixLevel[i*N+j]의 Mute 멤버를 TRUE로 설정해야 합니다.

KSAUDIO_MIXLEVEL 배열의 크기는 KSPROPERTY_AUDIO_MIX_LEVEL_CAPS 검색되는 KSAUDIO_MIXCAP_TABLE구조에서 계산됩니다. 구조체의 InputChannels 및 OutputChannels 멤버에 m 및 n 값이 포함된 경우 배열 크기는 입니다.

M * N * sizeof(KSAUDIO_MIXLEVEL)

반환 값

KSPROPERTY_AUDIO_MIX_LEVEL_TABLE 속성 요청은 STATUS_SUCCESS 반환하여 성공적으로 완료되었음을 나타냅니다. 그렇지 않으면 요청은 코드에 적절한 오류 상태 반환합니다.

설명

필터는 필터 범위를 벗어나지만(자동으로) 값을 지원되는 범위로 고정하는 혼합 수준 값(KSAUDIO_MIXLEVEL 수준 멤버)을 지정하는 KSPROPERTY_AUDIO_MIX_LEVEL_TABLE set-property 요청에 성공합니다. 그러나 이 속성을 가져오는 후속 요청에서 필터는 사용된 실제 값을 출력합니다.