IAudioSessionControl::GetGroupingParam 메서드(audiopolicy.h)

GetGroupingParam 메서드는 오디오 세션의 그룹화 매개 변수를 검색합니다.

구문

HRESULT GetGroupingParam(
  [out] GUID *pRetVal
);

매개 변수

[out] pRetVal

grouping-parameter GUID에 대한 출력 포인터입니다. 이 매개 변수는 호출자가 할당한 GUID 변수에 대한 유효한 NULL 이 아닌 포인터여야 합니다. 메서드는 그룹화 매개 변수를 이 변수에 씁니다.

반환 값

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

반환 코드	설명
E_POINTER	pRetVal 매개 변수는 NULL입니다.
AUDCLNT_E_DEVICE_INVALIDATED	오디오 엔드포인트 디바이스가 분리되었거나 오디오 하드웨어 또는 관련 하드웨어 리소스가 다시 구성, 비활성화, 제거 또는 사용할 수 없게 되었습니다.
AUDCLNT_E_SERVICE_NOT_RUNNING	Windows 오디오 서비스가 실행되고 있지 않습니다.

설명

그룹화 매개 변수 값이 동일한 모든 오디오 세션은 시스템 볼륨 제어 프로그램인 Sndvol에서 동일한 볼륨 수준 슬라이더를 제어합니다. 자세한 내용은 매개 변수 그룹화 를 참조하세요.

클라이언트는 IAudioSessionControl::SetGroupingParam 메서드를 호출하여 세션의 그룹화 매개 변수를 변경할 수 있습니다.

클라이언트가 오디오 세션에 그룹화 매개 변수를 할당하기 위해 SetGroupingParam 을 호출한 적이 없는 경우 세션의 그룹화 매개 변수 값은 기본적으로 GUID_NULL GetGroupingParam 호출은 이 값을 검색합니다. GUID_NULL 그룹화 매개 변수 값은 세션이 그룹에 속하지 않음을 나타냅니다. 이 경우 세션에는 Sndvol 프로그램에 자체 볼륨 수준 슬라이더가 있습니다.

요구 사항

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

추가 정보

IAudioSessionControl 인터페이스

IAudioSessionControl::SetGroupingParam