IPersistMediaPropertyBag::Load-Methode (strmif.h)

Artikel
03/02/2024

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die Load -Methode lädt Eigenschaften aus dem Medieneigenschaftenbehälter in den Filter.

Syntax

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

Parameter

[in] pPropBag

Zeiger auf die IMediaPropertyBag-Schnittstelle eines vom Aufrufer erstellten Medieneigenschaftenbehälters.

[in] pErrorLog

Reserviert. Legen Sie den Wert auf NULL fest.

Rückgabewert

Gibt einen HRESULT-Wert zurück. Folgende Werte sind möglich:

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
E_POINTER	NULL-Zeigerargument.
STG_E_ACCESSDENIED	Zugriff verweigert.
VFW_E_WRONG_STATE	Das Filterdiagramm befindet sich nicht in einem beendeten Zustand.

Hinweise

Rufen Sie diese Methode im AVI Mux-Filter auf, um die Eigenschaften in den AVI-Stream zu schreiben. Rufen Sie die -Methode auf, wenn der Filter beendet wird, bevor Sie das Filterdiagramm ausführen, um die Datei zu erstellen. Wenn das Diagramm ausgeführt wird, schreibt der Filter die INFO-Blöcke in den AVI-Header.

Im folgenden Codebeispiel wird einer Datei ein INFO-Block von IART (Autorname) hinzugefügt:

C++
IPersistMediaPropertyBag pPersist = NULL; IMediaPropertyBag pBag = NULL; VARIANT val; Fragen Sie den AVI Mux-Filter für IPersistMediaPropertyBag ab (nicht angezeigt). 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);

C++

IPersistMediaPropertyBag *pPersist = NULL; IMediaPropertyBag *pBag = NULL; VARIANT val;Fragen Sie den AVI Mux-Filter für IPersistMediaPropertyBag ab (nicht angezeigt).
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);

Der AVI-Splitterfilter und der WAVE-Parser unterstützen diese Methode nicht.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	strmif.h (include Dshow.h)
Bibliothek	Strmiids.lib

Weitere Informationen

Fehler- und Erfolgscodes

IPersistMediaPropertyBag-Schnittstelle

Freigeben über