IVMRImagePresenter ::StartPresenting, 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 in Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation au lieu de DirectShow, si 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 StartPresenting méthode est appelée juste avant le début de la lecture de la vidéo. L’allocator-presenter doit effectuer toute configuration nécessaire dans cette méthode.
Syntaxe
HRESULT StartPresenting(
[in] DWORD_PTR dwUserID
);
Paramètres
[in] dwUserID
Un cookie de DWORD_PTR défini par l’application qui identifie de manière unique cette instance du VMR pour une utilisation dans les scénarios où une instance de l’allocator-presenter est utilisée avec plusieurs instances VMR.
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 peuvent être appelés uniquement dans un état en cours d’exécution. Par conséquent, si le graphique est suspendu avant son exécution, PresentImage est appelé avant StartPresenting.
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 |