Skip to main content

IAudioStateMonitor::RegisterCallback method

IAudioStateMonitor와 연결된 스트림의 오디오 레벨이 변경될 때 시스템이 호출할 콜백 함수를 등록합니다.

Syntax

Parameters

callback
Type: AudioStateMonitorCallback*
IAudioStateMonitor와 연결된 스트림의 오디오 레벨이 변경될 때 시스템에 의해 호출되는 콜백 함수에 대한 포인터입니다. context
Type: void*
callback 매개변수에 지정된 함수로 전달될 앱 정의 컨텍스트 데이터에 대한 포인터입니다. registration [out]
Type: AudioStateMonitorRegistration*
콜백 등록을 식별하는 64비트 정수입니다. callback 매개변수에 지정된 함수의 등록을 해제하려면 이 값을 IAudioStateMonitor::UnregisterCallback에 전달하세요.

Return value

Type: HRESULT 메서드가 성공하면 S_OK를 반환합니다. 실패하면 가능한 반환 코드에는 다음 표에 표시된 값이 포함되지만 이에 국한되지는 않습니다.

Remarks

다음 시나리오를 고려해 보세요. 게임이 정책상 OS에 의해 오디오가 음소거되지 않을 것이 확실할 때만 GameMedia 오디오를 재생하도록 선택합니다. 이를 위해 게임은 기본 콘솔 엔드포인트에서 AudioCategory_GameMedia 스트림 카테고리에 대한 SoundLevel 알림에 등록합니다. 이 카테고리의 SoundLevel이 ‘Muted’로 설정되면 게임은 GameMedia 스트림의 재생을 중지합니다. SoundLevel이 다른 값으로 설정되면 게임은 GameMedia 스트림을 재생하도록 선택합니다.

Requirements

Header: Audiostatemonitorapi.h 지원 플랫폼: Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

See also

IAudioStateMonitor WASAPI 소개
마지막 수정일 2026년 8월 24일