Méthode IPersistMediaPropertyBag ::Load (strmif.h)

Article
01/10/2024

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La capture audio/vidéo dans Media Foundation au lieu de DirectShow, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La Load méthode charge les propriétés du conteneur de propriétés multimédias dans le filtre.

Syntaxe

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

Paramètres

[in] pPropBag

Pointeur vers l’interface IMediaPropertyBag d’un sac de propriétés multimédia créé par l’appelant.

[in] pErrorLog

Réservé. Définissez la valeur NULL.

Valeur retournée

Retourne une valeur HRESULT . Il peut prendre les valeurs suivantes :

Code de retour	Description
S_OK	Réussite.
E_POINTER	Argument pointeur NULL .
STG_E_ACCESSDENIED	Accès refusé.
VFW_E_WRONG_STATE	Le graphe de filtre n’est pas dans un état arrêté.

Remarques

Appelez cette méthode sur le filtre AVI Mux pour écrire les propriétés dans le flux AVI. Appelez la méthode lorsque le filtre est arrêté, avant d’exécuter le graphe de filtre pour créer le fichier. Lorsque le graphique s’exécute, le filtre écrit les blocs INFO dans l’en-tête AVI.

L’exemple de code suivant ajoute un segment INFO IART (nom de l’auteur) à un fichier :

C++
IPersistMediaPropertyBag pPersist = NULL ; IMediaPropertyBag pBag = NULL ; VARIANT val ; Interrogez le filtre AVI Mux pour IPersistMediaPropertyBag (non affiché). 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 ;Interrogez le filtre AVI Mux pour IPersistMediaPropertyBag (non affiché).
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);

Le filtre de fractionnement AVI et l’analyseur WAVE ne prennent pas en charge cette méthode.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	strmif.h (include Dshow.h)
Bibliothèque	Strmiids.lib

Voir aussi

Codes d’erreur et de réussite

IPersistMediaPropertyBag, interface

Partager via