共用方式為


IAudioEndpointVolumeCallback::OnNotify 方法 (endpointvolume.h)

OnNotify 方法會通知用戶端音訊端點裝置的音量層級或靜音狀態已變更。

語法

HRESULT OnNotify(
  [in] PAUDIO_VOLUME_NOTIFICATION_DATA pNotify
);

參數

[in] pNotify

磁碟區通知數據的指標。 此參數指向類型 為 AUDIO_VOLUME_NOTIFICATION_DATA的結構。

傳回值

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

備註

pNotify 參數指向描述起始 OnNotify 呼叫的磁碟區變更事件的結構。 此結構包含事件內容 GUID。 此 GUID 可讓用戶端區分磁碟區 (或靜音) 變更所起始的磁碟區,以及一個其他用戶端起始的變更。 呼叫變更數據流磁碟區層級的 IAudioEndpointVolume 方法時,用戶端會將指標傳遞給其 OnNotify 方法實作的事件內容 GUID。 pNotify 指向的結構包含此內容 GUID。 如果變更磁碟區層級的用戶端為事件內容 GUID 的指標提供 NULL 指標值, pNotify 所指向結構中的事件內容 GUID 值會GUID_NULL。

當系統變更系統中的磁碟區時,系統磁碟區使用者介面不會指定GUID_NULL。 第三方 OSD 應用程式可以區分主要磁碟區控制變更,這些變更是由系統的磁碟區使用者介面所產生,以及其他磁碟區變更,例如來自內建磁碟區控制處理程式的變更。

如需實作 OnNotify 方法的程式代碼範例,請參閱 端點磁碟區控件

規格需求

需求
最低支援的用戶端 Windows Vista [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 endpointvolume.h

另請參閱

AUDIO_VOLUME_NOTIFICATION_DATA

IAudioEndpointVolume 介面

IAudioEndpointVolumeCallback 介面