共用方式為

CBaseAllocator.Alloc 方法

  • 發行項

[與此頁面 相關的功能 DirectShow是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式碼，以使用新的 API。]

方法 Alloc 會配置緩衝區的記憶體。

語法

virtual HRESULT Alloc();

參數

這個方法沒有任何參數。

傳回值

傳回下列其中一個 HRESULT 值。

傳回碼 Description
S_FALSE
 緩衝區需求尚未變更。
S_OK
 緩衝區需求已變更。
VFW_E_SIZENOTSET
 未設定緩衝區需求。

備註

這個方法是由 CBaseAllocator：：Commit 方法呼叫。

在基類中，這個方法不會配置任何記憶體。 如果未設定緩衝區需求，則會傳回錯誤，S_FALSE需求未變更，並在需求變更時S_OK。

衍生類別應該覆寫這個方法，以執行實際的記憶體配置。 一般而言，衍生類別會執行下列步驟：

  1. 呼叫基類實作，以判斷記憶體是否真正需要配置。
  2. 配置記憶體。
  3. 建立 CMediaSample 物件，其中包含步驟 2 中的記憶體區塊。
  4. 將每個 CMediaSample 物件新增至 CBaseAllocator：：m_lFree) 的免費 (範例清單。

如需範例，請參閱 CMemAllocator：：Alloc。

規格需求

需求 值
標頭
Amfilter.h (包含 Streams.h)
程式庫
Strmbase.lib (零售組建) ;
Strmbasd.lib (偵錯組建)

另請參閱

CBaseAllocator 類別