Enumeração VMRRenderPrefs (strmif.h)

  • Artigo

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O tipo de enumeração VMRRenderPrefs é usado com os métodos IVMRFilterConfig::GetRenderingPrefs e IVMRFilterConfig::SetRenderingPrefs para obter e definir preferências básicas de renderização.

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
Não implementado; não use.
RenderPrefs_ForceOffscreen
Valor: 0x1
Indica que o Filtro do Renderizador de Combinação de Vídeo 7 (VMR-7) deve usar apenas superfícies fora da tela para renderização.
RenderPrefs_ForceOverlays
Valor: 0x2
Indica que a VMR-7 deve falhar se nenhuma superfície de sobreposição estiver disponível.
RenderPrefs_AllowOverlays
Valor: 0
Indica que a VMR-7 deve usar sobreposições se estiverem disponíveis. Não deve ser usado por novos aplicativos.
RenderPrefs_AllowOffscreen
Valor: 0
Indica que a VMR-7 deve usar superfícies fora da tela se nenhuma sobreposição estiver disponível. Não deve ser usado por novos aplicativos.
RenderPrefs_DoNotRenderColorKeyAndBorder
Valor: 0x8
Indica que o aplicativo é responsável por pintar as teclas de cor.
RenderPrefs_Reserved
Valor: 0x10
Reservado; não use.
RenderPrefs_PreferAGPMemWhenMixing
Valor: 0x20
Indica que a VMR-7 deve tentar usar a memória AGP ao alocar superfícies de textura.
RenderPrefs_Mask
Valor: 0x3f
OR bit a bit de todos os sinalizadores acima.

Comentários

Por padrão, a VMR-7 tenta alocar superfícies de textura DirectDraw da Memória de Vídeo e volta para a memória AGP se não houver memória de vídeo restante para atender à alocação. Para que a VMR-7 use a memória AGP, os elementos gráficos cartão devem ter algum suporte básico para blitting da memória do AGP para a Memória de Vídeo.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho strmif.h (inclua Dshow.h)

Confira também

Tipos enumerados do DirectShow