IAudioEndpointVolume::UnregisterControlChangeNotify 方法 (endpointvolume.h)
UnregisterControlChangeNotify方法會刪除用戶端在先前呼叫IAudioEndpointVolume::RegisterControlChangeNotify方法中註冊的用戶端通知回呼介面註冊。
語法
HRESULT UnregisterControlChangeNotify(
[in] IAudioEndpointVolumeCallback *pNotify
);
參數
[in] pNotify
用戶端 IAudioEndpointVolumeCallback 介面的指標。 用戶端在先前呼叫 IAudioEndpointVolume::RegisterControlChangeNotify 方法中,將這個相同的介面指標傳遞至端點磁片區物件。 如果UnregisterControlChangeNotify方法成功,它會在用戶端的IAudioEndpointVolumeCallback介面上呼叫Release方法。
傳回值
如果方法成功,它會傳回 S_OK。 如果失敗,可能的傳回碼包括,但不限於下表所示的值。
傳回碼 | 描述 |
---|---|
|
參數 pNotify 為 Null。 |
備註
在用戶端釋放 IAudioEndpointVolumeCallback 介面的最終參考之前,它應該呼叫 UnregisterControlChangeNotify 來取消註冊介面。 否則,應用程式會洩漏 IAudioEndpointVolumeCallback 和 IAudioEndpointVolume 物件所持有的資源。 請注意 ,IAudioEndpointVolume::RegisterControlChangeNotify 方法會呼叫用戶端的 IAudioEndpointVolumeCallback::AddRef 方法,而 UnregisterControlChangeNotify 會呼叫 IAudioEndpointVolumeCallback::Release 方法。 如果用戶端在呼叫UnregisterControlChangeNotify之前釋放其IAudioEndpointVolumeCallback介面的參考,則 IAudioEndpointVolume物件永遠不會釋放對IAudioEndpointVolumeCallback介面的參考。 例如,設計不佳的IAudioEndpointVolumeCallback實作可能會從IAudioEndpointVolumeCallback物件的解構函式呼叫UnregisterControlChangeNotify。 在此情況下,用戶端不會呼叫 UnregisterControlChangeNotify ,直到 IAudioEndpointVolume 物件釋放其 IAudioEndpointVolumeCallback 介面的參考,而 IAudioEndpointVolume 物件將不會釋放其對 IAudioEndpointVolumeCallback 介面的參考,直到用戶端呼叫 UnregisterControlChangeNotify為止。 如需 AddRef 和 Release 方法的詳細資訊,請參閱 Windows SDK 檔中的 IUnknown 介面討論。
如需呼叫 UnregisterControlChangeNotify的程式碼範例,請參閱 端點磁片區控制項。
需求
最低支援的用戶端 | Windows Vista [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | endpointvolume.h |
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應