Interface IVMRSurfaceAllocatorNotify (strmif.h)
[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.]
A IVMRSurfaceAllocatorNotify interface é implementada pelo Filtro do Renderizador de Combinação de Vídeos 7 (VMR-7). Os aplicativos usam essa interface para definir um alocador-apresentador personalizado e o alocador-apresentador usa essa interface para informar a VMR-7 de alterações no ambiente do sistema que afetam as superfícies do DirectDraw.
Para que um aplicativo obtenha essa interface, a VMR deve estar no modo sem renderização.
Para a VMR-9, use a interface IVMRSurfaceAllocatorNotify9 .
Herança
A interface IVMRSurfaceAllocatorNotify herda da interface IUnknown . IVMRSurfaceAllocatorNotify também tem estes tipos de membros:
Métodos
A interface IVMRSurfaceAllocatorNotify tem esses métodos.
| IVMRSurfaceAllocatorNotify::AdviseSurfaceAllocator O método AdviseSurfaceAllocator é chamado por um aplicativo para instruir a VMR a usar um alocador-apresentador personalizado. |
| IVMRSurfaceAllocatorNotify::ChangeDDrawDevice O método ChangeDDrawDevice notifica a VMR de que o dispositivo de reprodução DirectDraw foi alterado. Por exemplo, em um sistema de vários monitores, o usuário moveu o retângulo de vídeo de um monitor para outro. |
| IVMRSurfaceAllocatorNotify::NotifyEvent O método NotifyEvent é chamado pelo alocador-apresentador para informar a VMR de quaisquer eventos significativos do DirectShow durante os processos de alocação ou apresentação. |
| IVMRSurfaceAllocatorNotify::RestoreDDrawSurfaces O método RestoreDDrawSurfaces notifica a VMR de que uma "perda" de superfície do DirectDraw foi detectada. |
| IVMRSurfaceAllocatorNotify::SetBorderColor O método SetBorderColor especifica para a VMR qual cor usar em áreas do retângulo de exibição que não estão sendo usadas para vídeo, por exemplo, quando o vídeo está em caixa de correio. |
| IVMRSurfaceAllocatorNotify::SetDDrawDevice O método SetDDrawDevice define o dispositivo DirectDraw inicial e o monitor a serem usados para reprodução de vídeo. |
Requisitos
| Cliente mínimo com suporte | Windows XP com SP1 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | strmif.h (inclua Dshow.h) |