Skip to main content

IAudioStateMonitor::RegisterCallback 方法

註冊回呼函式,當與 IAudioStateMonitor 相關聯之串流的音訊層級變更時,系統會呼叫此函式。

語法

參數

callback
類型: AudioStateMonitorCallback*
回呼函式的指標,當與 IAudioStateMonitor 相關聯之串流的音訊層級發生變更時,系統會呼叫此函式。 context
類型: void*
應用程式定義之內容資料的指標,此資料會傳遞至 callback 參數中指定的函式。 registration [out]
類型: AudioStateMonitorRegistration*
識別回呼註冊的 64 位元整數。若要取消註冊 callback 參數中指定的函式,請將此值傳遞至 IAudioStateMonitor::UnregisterCallback。

傳回值

類型: HRESULT 如果方法成功,會傳回 S_OK。如果失敗,可能的傳回碼包括 (但不限於) 下表所示的值。

備註

請考慮下列案例:遊戲只有在確知音訊不會因原則而被 OS 靜音時,才會播放 GameMedia 音訊。為此,遊戲會在預設主機端點上,註冊 AudioCategory_GameMedia 串流類別的 SoundLevel 通知。如果此類別的 SoundLevel 設定為 ‘Muted’,遊戲會停止播放其 GameMedia 串流。如果 SoundLevel 設定為其他任何值,遊戲會選擇播放其 GameMedia 串流。

需求

標頭: Audiostatemonitorapi.h 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機

另請參閱

IAudioStateMonitor 關於 WASAPI
Last modified on October 6, 2026