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

SetGroupingParam 메서드는 세션을 세션 그룹화에 할당합니다.

구문

HRESULT SetGroupingParam(
  [in] LPCGUID Override,
  [in] LPCGUID EventContext
);

매개 변수

[in] Override

새 그룹화 매개 변수입니다. 이 매개 변수는 grouping-parameter GUID에 대한 유효한 NULL 이 아닌 포인터여야 합니다. 자세한 내용은 설명 부분을 참조하세요.

[in] EventContext

이벤트 컨텍스트 GUID에 대한 포인터입니다. 이 메서드를 호출하면 grouping-change 이벤트가 생성되면 세션 관리자는 세션 관리자에 IAudioSessionEvents 인터페이스를 등록한 모든 클라이언트에 알림을 보냅니다. 세션 관리자는 각 알림과 함께 EventContext 포인터 값을 포함합니다. 알림을 받으면 클라이언트는 EventContext 값을 검사하여 해당 클라이언트 또는 다른 클라이언트가 이벤트의 원본인지 여부를 확인할 수 있습니다. 이 체계는 세션의 모든 클라이언트에서 고유한 이 매개 변수에 대한 값을 선택하는 클라이언트에 따라 달라집니다. 호출자가 이 매개 변수에 대한 NULL 포인터를 제공하는 경우 클라이언트의 알림 메서드는 NULL 컨텍스트 포인터를 받습니다.

반환 값

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

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

설명

클라이언트는 세션의 그룹화 매개 변수를 변경하기 위해 이 메서드를 호출합니다. 그룹화 매개 변수 값이 동일한 모든 오디오 세션은 시스템 볼륨 제어 프로그램인 Sndvol에서 동일한 볼륨 수준 슬라이더를 제어합니다. 자세한 내용은 매개 변수 그룹화 를 참조하세요.

클라이언트는 IAudioSessionControl::GetGroupingParam 메서드를 호출하여 세션에 대한 현재 그룹화 매개 변수를 가져올 수 있습니다.

클라이언트가 SetGroupingParam을 호출하여 세션에 그룹화 매개 변수를 할당한 적이 없는 경우 세션은 어떤 그룹화에도 속하지 않습니다. 그룹화에 속하지 않는 세션에는 Sndvol 프로그램에 고유한 전용 볼륨 수준 슬라이더가 있습니다.

요구 사항

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

추가 정보

IAudioSessionControl 인터페이스

IAudioSessionControl::GetGroupingParam

IAudioSessionEvents 인터페이스