IAudioSessionControl2::GetSessionIdentifier 메서드(audiopolicy.h)

  • 아티클

GetSessionIdentifier 메서드는 오디오 세션 식별자를 검색합니다.

구문

HRESULT GetSessionIdentifier(
  [out] LPWSTR *pRetVal
);

매개 변수

[out] pRetVal

오디오 세션 식별자를 수신하는 null로 끝나는 와이드 문자열의 주소에 대한 포인터입니다. 문자열은 이 메서드에 의해 할당되며 CoTaskMemFree를 호출하여 호출자가 해제해야 합니다. CoTaskMemFree에 대한 자세한 내용은 Windows SDK 설명서를 참조하세요.

반환 값

메서드가 성공하면 S_OK가 반환되고, 실패할 경우 가능한 반환 코드는 다음 표에 표시된 값을 포함하지만 이에 국한되지 않습니다.

반환 값 설명
E_POINTER
 pRetVal 은 NULL입니다.
AUDCLNT_E_DEVICE_INVALIDATED
 기본 오디오 디바이스에서 오디오 세션의 연결이 끊어졌습니다.

설명

각 오디오 세션은 식별자 문자열로 식별됩니다. 이 세션 식별자 문자열은 모든 인스턴스에서 고유하지 않습니다. 두 개의 애플리케이션 인스턴스가 재생 중인 경우 두 인스턴스 모두 동일한 세션 식별자를 갖게 됩니다. GetSessionIdentifier에서 검색한 식별자는 모든 세션에서 고유한 세션 instance 식별자와 다릅니다. 세션 instance 식별자를 얻으려면 IAudioSessionControl2::GetSessionInstanceIdentifier를 호출합니다.

GetSessionIdentifier 는 기본 디바이스에서 세션의 연결이 끊어졌는지 확인합니다. 디바이스의 오디오 클라이언트에서 캐시하는 식별자 문자열을 검색합니다. 세션 식별자를 찾을 수 없는 경우 이 메서드는 오디오 엔진에서 검색합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 audiopolicy.h

추가 정보

IAudioSessionControl2