KSPROPERTY_AEC_STATUS

KSPROPERTY_AEC_STATUS 속성은 AEC 노드(KSNODETYPE_ACOUSTIC_ECHO_CANCEL)의 상태 모니터링하는 데 사용됩니다. AEC 노드의 선택적 속성입니다.

사용 요약 테이블

속성 값(작업 데이터)은 ULONG 형식입니다. 헤더 파일 Ksmedia.h에 정의된 다음 표의 왼쪽 열에 있는 하나 이상의 플래그 비트의 비트 OR로 설정할 수 있는 상태 값입니다. 헤더 파일 Dsound.h의 해당 DSCFX_AEC_STATUS 플래그가 테이블의 오른쪽 열에 표시됩니다. 이러한 플래그에 대한 자세한 내용은 Microsoft Windows SDK 설명서를 참조하세요.

반환 값

KSPROPERTY_AEC_STATUS 속성 요청은 성공적으로 완료되었음을 나타내는 STATUS_SUCCESS 반환합니다. 그렇지 않으면 요청이 적절한 오류 상태 코드를 반환합니다.

설명

AEC 상태 플래그에서 가장 중요하지 않은 세 비트(앞의 표 참조)는 AEC 알고리즘의 CH(수렴 기록)를 나타냅니다. CH 상태 비트는 Microsoft DirectSound 애플리케이션에서 알고리즘이 수렴되었는지 여부와 데이터 처리를 시작한 이후 수렴된 상태로 유지되었는지 여부를 확인하는 데 사용할 수 있습니다. 오디오 하드웨어에 따라 AEC 알고리즘이 수렴되지 않을 수 있으며, 이 경우 결과 캡처 버퍼에 스피커의 에코가 포함될 수 있습니다.

AEC 노드를 포함하는 필터가 만들어지거나 노드가 다시 설정되면 AEC 알고리즘은 처음에 3개의 CH 상태 비트를 0으로 설정합니다. 이 설정은 초기화되지 않은 상태(AEC_STATUS_FD_HISTORY_UNINITIALIZED)를 나타냅니다.

AEC 알고리즘이 수렴되면 CH 상태 AEC_STATUS_FD_HISTORY_CONTINUOUSLY_CONVERGED 수렴된 상태로 전환됩니다. AEC 알고리즘이 수렴성을 상실하면 CH 상태 AEC_STATUS_FD_HISTORY_PREVIOUSLY_DIVERGED 분기된 상태로 전환됩니다. 상태 수렴된 상태에서 분기된 상태로 전환할 가능성이 가장 높지만 초기화되지 않은 상태에서 분기된 상태로 직접 전환할 수도 있습니다. CH 상태 분기된 상태로 전환한 후에는 알고리즘이 다시 설정되거나 기아가 감지될 때까지 해당 상태로 유지됩니다.

AEC 시스템 필터가 4개의 핀(캡처, 캡처, 렌더링 또는 렌더링)에서 기아를 감지하면 수렴 기록을 포함하여 내부 상태가 다시 설정됩니다.

3개의 CH 상태 비트 중 비트 2는 현재 사용되지 않습니다.

CH 상태 비트를 사용하는 대신 애플리케이션은 AEC_STATUS_FD_CURRENTLY_CONVERGED 플래그 비트를 확인하여 실시간 수렴 상태 모니터링할 수 있습니다. 이 비트를 설정하면 알고리즘이 현재 수렴됩니다. 음향 경로에서 변경이 발생하면 알고리즘이 일시적으로 수렴을 잃을 수 있습니다. 이러한 순간적인 손실이 CH 상태 비트를 DSCFX_AEC_STATUS_FD_HISTORY_PREVIOUSLY_DIVERGED 상태로 부적절하게 전환하지 못하도록 실시간 수렴 플래그가 필터링됩니다.

요구 사항

참고 항목

KSNODEPROPERTY

KSNODETYPE_ACOUSTIC_ECHO_CANCEL