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 方法的程式代碼範例，請參閱 端點磁碟區控件。

規格需求

另請參閱

AUDIO_VOLUME_NOTIFICATION_DATA

IAudioEndpointVolume 介面

IAudioEndpointVolumeCallback 介面