IAudioSessionEvents：：OnDisplayNameChanged 方法 (audiopolicy.h)

OnDisplayNameChanged 方法會通知用戶端會話的顯示名稱已變更。

語法

HRESULT OnDisplayNameChanged(
  [in] LPCWSTR NewDisplayName,
  [in] LPCGUID EventContext
);

參數

[in] NewDisplayName

工作階段的新顯示名稱。 此參數指向包含新顯示名稱的 Null 終止寬字元字串。 字串在呼叫期間會維持有效狀態。

[in] EventContext

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

傳回值

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

備註

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

EventContext 參數提供一種方法，可讓客戶端區別其起始的顯示名稱變更，以及一個其他用戶端起始的變更。 呼叫 IAudioSessionControl：：SetDisplayName 方法時，用戶端會傳入 EventContext 參數值，其 OnDisplayNameChanged 方法的實作可以辨識。

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

規格需求

另請參閱

IAudioSessionControl：：SetDisplayName

IAudioSessionEvents 介面