IAudioSessionEvents：：OnIconPathChanged 方法 (audiopolicy.h)

OnIconPathChanged 方法會通知用戶端會話的顯示圖示已變更。

語法

HRESULT OnIconPathChanged(
  [in] LPCWSTR NewIconPath,
  [in] LPCGUID EventContext
);

參數

[in] NewIconPath

會話之新顯示圖示的路徑。 此參數指向包含新圖示路徑的字串。 字串指標只會在呼叫期間保持有效。

[in] EventContext

事件內容值。 這是呼叫端在變更會話顯示圖示的呼叫中傳遞至 IAudioSessionControl：：SetIconPath 的相同值。 如需詳細資訊，請參閱＜備註＞。

傳回值

如果方法成功，它會傳回 S_OK。 如果方法失敗，則會傳回錯誤碼。

備註

會話管理員每次呼叫 IAudioSessionControl：：SetIconPath 方法都會變更會話的顯示圖示時呼叫這個方法。 Sndvol 程式會使用會話的顯示圖示來標記會話的磁碟區滑桿。

EventContext 參數提供一種方法，可讓用戶端區分它所起始的顯示圖示變更，以及一個其他用戶端起始的變更。 呼叫 IAudioSessionControl：：SetIconPath 方法時，用戶端會傳入 EventContext 參數值，其 實作 OnIconPathChanged 方法可以辨識。

如需實作 IAudioSessionEvents 介面中方法的程式代碼範例，請參閱 音訊會話事件。

規格需求

另請參閱

IAudioSessionControl：：SetIconPath

IAudioSessionEvents 介面