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

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

구문

HRESULT GetSessionInstanceIdentifier(
  [out] LPWSTR *pRetVal
);

매개 변수

[out] pRetVal

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

반환 값

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

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

설명

instance 각 오디오 세션은 고유한 문자열로 식별됩니다. 이 문자열은 오디오 세션의 특정 instance 나타내며 세션 식별자와 달리 모든 인스턴스에서 고유합니다. 재생 중인 애플리케이션 인스턴스가 두 개 있는 경우 식별자에 instance 세션이 다릅니다. GetSessionInstanceIdentifier에서 검색한 식별자는 모든 세션 인스턴스에서 공유하는 세션 식별자와 다릅니다. 세션 식별자를 얻으려면 IAudioSessionControl2::GetSessionIdentifier를 호출합니다.

GetSessionInstanceIdentifier 는 기본 디바이스에서 세션의 연결이 끊어졌는지 확인합니다. 디바이스의 오디오 클라이언트에서 캐시하는 식별자 문자열을 검색합니다. 세션 instance 식별자를 찾을 수 없는 경우 이 메서드는 오디오 엔진에서 검색합니다. 세션 instance 식별자를 가져오는 방법에 대한 예제 코드는 통신 디바이스에서 Ducking 이벤트 가져오기를 참조하세요.

요구 사항

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

추가 정보

IAudioSessionControl2

통신 디바이스 사용