Énumération VMRRenderPrefs (strmif.h)

Article
03/04/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 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.]

Le type d’énumération VMRRenderPrefs est utilisé avec les méthodes IVMRFilterConfig ::GetRenderingPrefs et IVMRFilterConfig ::SetRenderingPrefs pour obtenir et définir les préférences de rendu de base.

Syntax

typedef enum VMRRenderPrefs {
  RenderPrefs_RestrictToInitialMonitor = 0,
  RenderPrefs_ForceOffscreen = 0x1,
  RenderPrefs_ForceOverlays = 0x2,
  RenderPrefs_AllowOverlays = 0,
  RenderPrefs_AllowOffscreen = 0,
  RenderPrefs_DoNotRenderColorKeyAndBorder = 0x8,
  RenderPrefs_Reserved = 0x10,
  RenderPrefs_PreferAGPMemWhenMixing = 0x20,
  RenderPrefs_Mask = 0x3f
} ;

Constantes


`RenderPrefs_RestrictToInitialMonitor` Valeur : 0 Non implémenté ; n’utilisez pas.
`RenderPrefs_ForceOffscreen` Valeur : 0x1 Indique que le filtre de rendu de mixage vidéo 7 (VMR-7) doit utiliser uniquement des surfaces hors écran pour le rendu.
`RenderPrefs_ForceOverlays` Valeur : 0x2 Indique que le VMR-7 doit échouer si aucune surface de superposition n’est disponible.
`RenderPrefs_AllowOverlays` Valeur : 0 Indique que le VMR-7 doit utiliser des superpositions si elles sont disponibles. Ne doit pas être utilisé par les nouvelles applications.
`RenderPrefs_AllowOffscreen` Valeur : 0 Indique que vmr-7 doit utiliser des surfaces hors écran si aucune superposition n’est disponible. Ne doit pas être utilisé par les nouvelles applications.
`RenderPrefs_DoNotRenderColorKeyAndBorder` Valeur : 0x8 Indique que l’application est responsable de la peinture des touches de couleur.
`RenderPrefs_Reserved` Valeur : 0x10 Réservé ; ne pas utiliser.
`RenderPrefs_PreferAGPMemWhenMixing` Valeur : 0x20 Indique que vmr-7 doit tenter d’utiliser la mémoire AGP lors de l’allocation de surfaces de texture.
`RenderPrefs_Mask` Valeur : 0x3f OR au niveau du bit de tous les indicateurs ci-dessus.

Remarques

Par défaut, vmR-7 tente d’allouer des surfaces de texture DirectDraw à partir de la mémoire vidéo et revient à la mémoire AGP s’il ne reste plus de mémoire vidéo pour remplir l’allocation. Pour que le VMR-7 utilise la mémoire AGP, les carte graphiques doivent avoir une prise en charge de base pour passer de la mémoire AGP à la mémoire vidéo.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	strmif.h (include Dshow.h)

Voir aussi

Types énumérés DirectShow

Partager via