KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST
KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST 속성은 특정 오디오 신호 처리 경로에 대해 특정 KS 핀 팩터리에 적용되는 오디오 효과 유형의 목록인 필터 속성입니다.
사용량 요약 테이블
사용량 요약 테이블
| 가져오기 | 설정 | 대상 | 속성 설명자 형식 | 속성 값 형식 |
|---|---|---|---|---|
Yes |
아니요 |
핀 팩터리(필터 instance 통해) |
KSP_PIN |
KSP_PINMODE |
속성 값은 KSP_PINMODE 구조체로 식별되는 핀의 신호 처리 경로에 있는 0개 이상의 오디오 효과 유형 GUID(예: AUDIO_EFFECT_TYPE_ACOUSTIC_ECHO_CANCELLATION )의 배열입니다.
참고 이 속성에 대해 KSPROPERTY_TYPE_TOPOLOGY 플래그 비트를 설정하면 안 됩니다.
반환 값
KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST 속성 요청은 STATUS_SUCCESS 반환하여 성공적으로 완료되었음을 나타냅니다. 그렇지 않으면 이 속성 요청은 코드에 적절한 오류 상태 반환합니다.
설명
오디오 드라이버가 Microsoft의 일반 프록시 APO를 사용하여 KS 핀에 대한 다양한 신호 처리 경로에 포함된 오디오 효과를 검색하는 경우 이 속성을 지원해야 합니다. 제네릭 프록시 APO는 msapofxproxy.dll 파일에 포함되어 있습니다. 오디오 드라이버는 APO에서 처리가 수행되지 않고 오디오 드라이버 또는 해당 DSP(디지털 신호 프로세서) 하드웨어 구성 요소에서 모든 신호 처리가 수행될 때 이 일반 프록시 APO를 사용할 수 있습니다. 이 경우 APO의 유일한 기능은 신호 처리 효과를 오디오 시스템에 보고하는 것입니다.
일반 프록시 APO는 오디오 드라이버에서 KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST 수신하고 이를 사용하여 오디오 시스템에 효과를 보고합니다. 제네릭 프록시 APO는 KS 핀의 필터 인터페이스를 사용하는 동안 효과 목록이 변경되지 않는다고 가정합니다.
속성 설명자가 KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST 지원하지 않는 KS 핀을 지정하는 경우 드라이버는 STATUS_NOT_SUPPORTED 반환해야 합니다.
속성 설명자가 드라이버에서 지원하지 않는 AudioProcessingMode 값을 지정하는 경우 드라이버는 STATUS_INVALID_PARAMETER 반환해야 합니다. 오디오 드라이버는 지원되는 오디오 신호 처리 모드를 나타낼 수 있도록 KSPROPERTY_AUDIOSIGNALPROCESSING_MODES 속성을 지원해야 합니다.
요구 사항
Version |
Windows 8.1 |
헤더 |
Msapofxproxy.h |