共用方式為

IPersistMediaPropertyBag：：Load 方法 (strmif.h)

  • 發行項

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

方法會將 Load 媒體屬性包中的屬性載入篩選。

語法

HRESULT Load(
  [in] IMediaPropertyBag *pPropBag,
  [in] IErrorLog         *pErrorLog
);

參數

[in] pPropBag

呼叫端所建立之媒體屬性包 之 IMediaPropertyBag 介面的指標。

[in] pErrorLog

保留的。 將值設定為 NULL。

傳回值

傳回 HRESULT 值。 可能的值如下：

傳回碼 描述
S_OK
 成功。
E_POINTER
 NULL 指標自變數。
STG_E_ACCESSDENIED
 拒絕存取。
VFW_E_WRONG_STATE
 篩選圖表不是處於已停止狀態。

備註

在 AVI Mux 篩選上呼叫這個方法，以將屬性寫入 AVI 數據流。 停止篩選條件時，請先呼叫 方法，再執行篩選圖形來撰寫檔案。 當圖形執行時，篩選會將 INFO 區塊寫入 AVI 標頭。

下列程式代碼範例會將 IART (作者名稱) INFO 區塊新增至檔案：

C++ 
IPersistMediaPropertyBag *pPersist = NULL;IMediaPropertyBag *pBag = NULL;VARIANT val;
查詢 IPersistMediaPropertyBag 的 AVI Mux 篩選器， (未顯示) 。


CoCreateInstance (CLSID_MediaPropertyBag、NULL、CLSCTX_INPROC、IID_IMediaPropertyBag、 (LPVOID *) &pBag) ;


val.vt = VT_BSTR;
val.bstrVal = SysAllocString(OLESTR("Author Name"));
pBag->Write(OLESTR("INFO/IART"), &val);
pPersist->Load(pBag, NULL);
VariantClear(&val);

AVI 分隔器篩選器和 WAVE 剖析器不支援此方法。

規格需求

需求 值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 strmif.h (包含 Dshow.h)
程式庫 Strmiids.lib

另請參閱

錯誤和成功碼

IPersistMediaPropertyBag 介面