IAudioEndpointVolume::SetMute 메서드(endpointvolume.h)

SetMute 메서드는 오디오 엔드포인트 디바이스로 들어오거나 나가는 오디오 스트림의 음소거 상태를 설정합니다.

구문

HRESULT SetMute(
  [in] BOOL    bMute,
  [in] LPCGUID pguidEventContext
);

매개 변수

[in] bMute

새 음소거 상태입니다. bMute가 TRUE이면 메서드는 스트림을 음소거합니다. FALSE이면 메서드가 음소거를 해제합니다.

[in] pguidEventContext

IAudioEndpointVolumeCallback::OnNotify 메서드에 대한 컨텍스트 값입니다. 이 매개 변수는 이벤트 컨텍스트 GUID를 가리킵니다. SetMute 호출이 엔드포인트의 음소거 상태를 변경하면 해당 엔드포인트에 IAudioEndpointVolumeCallback 인터페이스를 등록한 모든 클라이언트가 알림을 받습니다. OnNotify 메서드의 구현에서 클라이언트는 이벤트 컨텍스트 GUID를 검사하여 이벤트 또는 다른 클라이언트가 제어-변경 이벤트의 원본인지 여부를 검색할 수 있습니다. 호출자가 이 매개 변수에 대한 NULL 포인터를 제공하는 경우 알림 루틴은 GUID_NULL 컨텍스트 GUID 값을 받습니다.

반환 값

메서드가 성공하고 음소거 상태가 변경되면 메서드는 S_OK 반환합니다. 메서드가 성공하고 새 음소거 상태가 이전 음소거 상태와 같으면 메서드는 S_FALSE 반환합니다. 메서드가 실패하면 가능한 반환 코드에는 다음 표에 표시된 값이 포함되지만 이에 국한되지는 않습니다.

반환 코드	설명
E_OUTOFMEMORY	메모리가 부족합니다.

설명

SetMute를 호출하는 코드 예제는 엔드포인트 볼륨 컨트롤을 참조하세요.

요구 사항

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

추가 정보

IAudioEndpointVolume 인터페이스

IAudioEndpointVolumeCallback 인터페이스

IAudioEndpointVolumeCallback::OnNotify