Enumeración VMRRenderPrefs (strmif.h)

  • Artículo

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El tipo de enumeración VMRRenderPrefs se usa con los métodos IVMRFilterConfig::GetRenderingPrefs y IVMRFilterConfig::SetRenderingPrefs para obtener y establecer preferencias básicas de representación.

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
Valor: 0
No implementado; no use.
RenderPrefs_ForceOffscreen
Valor: 0x1
Indica que el filtro del representador de mezcla de vídeos 7 (VMR-7) solo debe usar superficies fuera de la pantalla para la representación.
RenderPrefs_ForceOverlays
Valor: 0x2
Indica que VMR-7 debe producir un error si no hay superficies de superposición disponibles.
RenderPrefs_AllowOverlays
Valor: 0
Indica que VMR-7 debe usar superposiciones si están disponibles. Las nuevas aplicaciones no deben usarse.
RenderPrefs_AllowOffscreen
Valor: 0
Indica que VMR-7 debe usar superficies fuera de la pantalla si no hay superposiciones disponibles. Las nuevas aplicaciones no deben usarse.
RenderPrefs_DoNotRenderColorKeyAndBorder
Valor: 0x8
Indica que la aplicación es responsable de pintar las teclas de color.
RenderPrefs_Reserved
Valor: 0x10
Reservado; no usar.
RenderPrefs_PreferAGPMemWhenMixing
Valor: 0x20
Indica que VMR-7 debe intentar usar la memoria de AGP al asignar superficies de textura.
RenderPrefs_Mask
Valor: 0x3f
OR bit a bit de todas las marcas anteriores.

Comentarios

De forma predeterminada, VMR-7 intenta asignar superficies de textura de DirectDraw de la memoria de vídeo y recurre a la memoria de AGP si no queda memoria de vídeo para cumplir la asignación. Para que VMR-7 use la memoria AGP, la tarjeta gráfica debe tener compatibilidad básica para la migración de memoria AGP a la memoria de vídeo.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado strmif.h (incluye Dshow.h)

Consulte también

Tipos enumerados de DirectShow