KSPROPERTY_AUDIO_ALGORITHM_INSTANCE

KSPROPERTY_AUDIO_ALGORITHM_INSTANCE 속성은 노드가 오디오 데이터 스트림에 적용되는 타사 효과를 달성하는 데 사용되는 DSP(디지털 신호 처리) 알고리즘을 지정합니다. 이 속성에 대해 정의된 효과에는 음향 에코 취소 및 노이즈 억제가 포함됩니다.

사용량 요약 테이블

가져오기 설정 대상 속성 설명자 형식 속성 값 형식

Yes

Yes

필터

KSNODEPROPERTY

GUID

속성 값(작업 데이터)은 핀이 데이터 스트림에 적용되는 효과를 식별하는 GUID입니다. 이 값은 헤더 파일 Ksmedia.h의 다음 GUID 중 하나일 수 있습니다.

KSALGORITHMINSTANCE_SYSTEM_AGC
나중에 사용하도록 예약되어 있습니다.

KSALGORITHMINSTANCE_SYSTEM_ACOUSTIC_ECHO_CANCEL
시스템 기본 음향 에코 취소 알고리즘

KSALGORITHMINSTANCE_SYSTEM_MICROPHONE_ARRAY_PROCESSOR
나중에 사용하도록 예약되어 있습니다.

KSALGORITHMINSTANCE_SYSTEM_NOISE_SUPPRESS
시스템 기본 노이즈 억제 알고리즘

반환 값

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

설명

이 속성은 AEC 노드(KSNODETYPE_ACOUSTIC_ECHO_CANCEL) 또는 노이즈 억제 노드(KSNODETYPE_NOISE_SUPPRESS)에서 수행하는 DSP 알고리즘을 제어하는 데 사용됩니다.

알고리즘 instance GUID는 호출자가 IDirectSoundCapture::CreateCaptureBuffer 메서드 또는 DirectSoundFullDuplexCreate 함수에 전달하는 DSCEFFECTDESC 구조체의 guidDSCFXInstance 멤버의 값과 일치합니다. 자세한 내용은 Microsoft Windows SDK 설명서를 참조하세요.

요구 사항

헤더

Ksmedia.h(Ksmedia.h 포함)

참고 항목

KSNODEPROPERTY

KSNODETYPE_ACOUSTIC_ECHO_CANCEL

KSNODETYPE_NOISE_SUPPRESS