IVMRImagePresenter ::P resentImage, méthode (strmif.h)
[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 PresentImage méthode est appelée précisément au moment où cette image vidéo doit être présentée.
Syntaxe
HRESULT PresentImage(
[in] DWORD_PTR dwUserID,
[in] VMRPRESENTATIONINFO *lpPresInfo
);
Paramètres
[in] dwUserID
Une DWORD_PTR définie par l’application qui identifie de manière unique cette instance du VMR dans les scénarios où plusieurs instances du VMR sont utilisées avec une seule instance d’un allocator-présentateur. Voir remarques
[in] lpPresInfo
Spécifie la structure VMRPRESENTATIONINFO .
Valeur retournée
Si la méthode réussit, retourne S_OK. En cas d'échec, retourne un code d'erreur.
Remarques
PresentImage peut être appelé lorsque le filtre est en cours d’exécution ou en pause. StartPresenting et StopPresenting ne peuvent être appelés que dans un état en cours d’exécution. Par conséquent, si le graphe est suspendu avant son exécution, PresentImage est appelé avant StartPresenting.
Les applications peuvent créer des effets de fusion personnalisés à l’aide d’un seul instance d’un Allocator-Presenter avec plusieurs instances du VMR dans un graphique de filtre unique ou dans plusieurs graphiques de filtre. L’utilisation du présentateur d’allocator de cette façon permet aux applications de fusionner des flux à partir de différents graphiques de filtre ou de fusionner différents flux au sein d’un même graphe de filtre. Si vous utilisez une seule instance du VMR, définissez cette valeur sur zéro.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP avec SP1 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | strmif.h (include Dshow.h) |
| Bibliothèque | Strmiids.lib |