IAudioSessionManager2::GetSessionEnumerator 方法 (audiopolicy.h)
GetSessionEnumerator 方法會取得音訊會話列舉值物件的指標。
語法
HRESULT GetSessionEnumerator(
[out] IAudioSessionEnumerator **SessionEnum
);
參數
[out] SessionEnum
接收會話列舉值物件的 IAudioSessionEnumerator 介面指標,用戶端可用來列舉音訊裝置上的音訊會話。 透過這個方法,呼叫端會取得介面的計數參考。 呼叫端負責藉由呼叫介面的 Release 方法,在不再需要介面時釋出介面。
傳回值
如果方法成功,它會傳回 S_OK。
備註
會話管理員會藉由查詢音訊引擎來維護音訊裝置上作用中的音訊會話集合。 GetSessionEnumerator 會為集合中的每個會話建立會話控件。 若要取得列舉集合中會話之 IAudioSessionControl 介面的參考,應用程式必須呼叫 IAudioSessionEnumerator::GetSession。 如需程式代碼範例,請參閱 IAudioSessionEnumerator 介面。
會話列舉值可能不知道透過 IAudioSessionNotification 報告的新會話。 因此,如果應用程式只依賴會話列舉值來取得音訊端點的所有會話,結果可能不正確。 若要解決此問題,應用程式應該手動維護清單。 如需詳細資訊,請參閱 IAudioSessionEnumerator。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 7 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 R2 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | audiopolicy.h |