IAudioSessionControl2::GetSessionInstanceIdentifier 메서드(audiopolicy.h)
GetSessionInstanceIdentifier 메서드는 오디오 세션 instance 식별자를 검색합니다.
구문
HRESULT GetSessionInstanceIdentifier(
[out] LPWSTR *pRetVal
);
매개 변수
[out] pRetVal
오디오 세션의 특정 instance 식별자를 수신하는 null로 끝나는 와이드 문자열의 주소에 대한 포인터입니다. 문자열은 이 메서드에 의해 할당되며 CoTaskMemFree를 호출하여 호출자가 해제해야 합니다. CoTaskMemFree에 대한 자세한 내용은 Windows SDK 설명서를 참조하세요.
반환 값
메서드가 성공하면 S_OK가 반환되고, 실패할 경우 가능한 반환 코드는 다음 표에 표시된 값을 포함하지만 이에 국한되지 않습니다.
| 반환 값 | 설명 |
|---|---|
|
pRetVal 은 NULL입니다. |
|
기본 오디오 디바이스에서 오디오 세션의 연결이 끊어졌습니다. |
설명
instance 각 오디오 세션은 고유한 문자열로 식별됩니다. 이 문자열은 오디오 세션의 특정 instance 나타내며 세션 식별자와 달리 모든 인스턴스에서 고유합니다. 재생 중인 애플리케이션 인스턴스가 두 개 있는 경우 식별자에 instance 세션이 다릅니다. GetSessionInstanceIdentifier에서 검색한 식별자는 모든 세션 인스턴스에서 공유하는 세션 식별자와 다릅니다. 세션 식별자를 얻으려면 IAudioSessionControl2::GetSessionIdentifier를 호출합니다.
GetSessionInstanceIdentifier 는 기본 디바이스에서 세션의 연결이 끊어졌는지 확인합니다. 디바이스의 오디오 클라이언트에서 캐시하는 식별자 문자열을 검색합니다. 세션 instance 식별자를 찾을 수 없는 경우 이 메서드는 오디오 엔진에서 검색합니다. 세션 instance 식별자를 가져오는 방법에 대한 예제 코드는 통신 디바이스에서 Ducking 이벤트 가져오기를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 7 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 R2 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | audiopolicy.h |