Partager via


Énumération VMRRenderPrefs (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.]

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