IMemAllocatorCallbackTemp：：SetNotify 方法 (strmif.h)
[與此頁面 相關的功能 DirectShow 是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對 Windows 10 和 Windows 11 進行優化。 Microsoft 強烈建議新程式代碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式代碼，以使用新的 API。]
方法 SetNotify 會設定或移除配置器上的回呼。 配置器會在呼叫配置器的 IMemAllocator：：ReleaseBuffer 方法時呼叫回呼方法。
語法
HRESULT SetNotify(
IMemAllocatorNotifyCallbackTemp *pNotify
);
參數
pNotify
將用於回呼之 IMemAllocatorNotifyCallbackTemp 介面的指標。 呼叫端必須實作 介面。 使用 NULL 值來移除回呼。
傳回值
如果成功，則傳回S_OK，否則傳回錯誤碼。
備註
每當呼叫配置器的 ReleaseBuffer 方法時，配置器會在 pNotify 中提供的介面上呼叫 NotifyRelease 方法。 ReleaseBuffer 方法會將媒體範例傳回配置器的免費清單。 範例在參考計數達到零時呼叫這個方法。
配置器會保留呼叫端 IMemAllocatorNotifyCallbackTemp 介面上的參考計數。 這可以建立迴圈參考計數，進而防止圖形中的對象正確釋放。 因此，當呼叫端不再需要回呼通知時，它應該使用 NULL值再次呼叫此方法。 要執行這項操作的適當時機是圖形停止時，否則當針腳中斷連線時。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | strmif.h (包含 Dshow.h) |
| 程式庫 | Strmiids.lib |