IAudioSessionManager2::GetSessionEnumerator 메서드(audiopolicy.h)

GetSessionEnumerator 메서드는 오디오 세션 열거자 개체에 대한 포인터를 가져옵니다.

구문

HRESULT GetSessionEnumerator(
  [out] IAudioSessionEnumerator **SessionEnum
);

매개 변수

[out] SessionEnum

클라이언트가 오디오 디바이스에서 오디오 세션을 열거하는 데 사용할 수 있는 세션 열거자 개체의 IAudioSessionEnumerator 인터페이스에 대한 포인터를 받습니다. 이 메서드를 통해 호출자는 인터페이스에 대해 계산된 참조를 가져옵니다. 호출자는 인터페이스의 Release 메서드를 호출하여 더 이상 필요하지 않은 경우 인터페이스를 해제 할 책임이 있습니다.

반환 값

메서드가 성공하면 S_OK가 반환되고,

설명

세션 관리자는 오디오 엔진을 쿼리하여 오디오 디바이스에서 활성 상태인 오디오 세션 컬렉션을 유지 관리합니다. GetSessionEnumerator 는 컬렉션의 각 세션에 대한 세션 컨트롤을 만듭니다. 열거된 컬렉션에서 세션의 IAudioSessionControl 인터페이스에 대한 참조를 얻으려면 애플리케이션에서 IAudioSessionEnumerator::GetSession을 호출해야 합니다. 코드 예제는 IAudioSessionEnumerator 인터페이스를 참조하세요.

세션 열거자는 IAudioSessionNotification을 통해 보고되는 새 세션을 인식하지 못할 수 있습니다. 따라서 애플리케이션이 오디오 엔드포인트에 대한 모든 세션을 가져오기 위해 세션 열거자를 단독으로 사용하는 경우 결과가 정확하지 않을 수 있습니다. 이 작업을 수행하려면 애플리케이션에서 목록을 수동으로 유지 관리해야 합니다. 자세한 내용은 IAudioSessionEnumerator를 참조하세요.

요구 사항

추가 정보

IAudioSessionManager2