IAudioSystemEffects2::GetEffectsList 메서드(audioenginebaseapo.h)

GetEffectsList 메서드는 현재 활성 상태인 오디오 처리 효과 목록을 검색하는 데 사용되며 목록이 변경되면 신호를 받을 이벤트를 저장합니다.

구문

HRESULT GetEffectsList(
  [out] LPGUID *ppEffectsIds,
  [out] UINT   *pcEffects,
  [in]  HANDLE Event
);

매개 변수

[out] ppEffectsIds

오디오 처리 효과를 나타내는 GUID 목록에 대한 포인터입니다. 호출자는 CoTaskMemFree를 호출하여 이 메모리를 해제할 책임이 있습니다.

[out] pcEffects

목록의 오디오 처리 효과 수입니다.

[in] Event

목록이 변경되면 신호를 받을 이벤트의 핸들입니다.

반환 값

GetEffectsList 메서드는 메서드 호출에 성공하면 S_OK 반환합니다. 목록에 효과가 없으면 함수는 계속 성공하고 , ppEffectsIds 는 NULL 포인터를 반환하고, pcEffects 는 0의 수를 반환합니다.

설명

APO는 오디오 처리 효과 목록이 GetEffectsList에서 반환된 목록에서 변경될 때 지정된 이벤트에 신호를 보냅니다. APO는 GetEffectsList 가 다시 호출되거나 APO가 제거될 때까지 이 이벤트를 사용합니다. 전달된 핸들은 NULL일 수 있습니다. 이 경우 APO는 이전 핸들 사용을 중지하고 이벤트 신호를 받지 않습니다.

APO는 Windows가 APO에 적용된 현재 효과를 검색할 수 있도록 이 메서드를 구현합니다. 효과 목록은 APO가 초기화한 처리 모드 및 최종 사용자 구성에 따라 달라질 수 있습니다. 처리 모드는 APOInitSystemEffects2의 AudioProcessingMode 멤버로 표시됩니다.

API는 windows에서 정의한 GUID(예: AUDIO_EFFECT_TYPE_ACOUSTIC_ECHO_CANCELLATION)를 사용하여 효과를 식별해야 합니다. APO는 효과 유형이 Windows에서 정의한 것과 명확하게 다른 드문 경우에만 사용자 지정 GUID를 정의하고 반환해야 합니다.

요구 사항

추가 정보

APOInitSystemEffects2

IAudioSystemEffects2