Método IVMRSurfaceAllocator::P repareSurface (strmif.h)
[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 PrepareSurface método prepara la superficie de DirectDraw para que el siguiente fotograma de vídeo se descodifique en ella.
Sintaxis
HRESULT PrepareSurface(
[in] DWORD_PTR dwUserID,
[in] LPDIRECTDRAWSURFACE7 lpSurface,
[in] DWORD dwSurfaceFlags
);
Parámetros
[in] dwUserID
Una cookie de DWORD_PTR definida por la aplicación que identifica de forma única esta instancia de VMR para su uso en escenarios en los que se usa una instancia del asignador-moderador con varias instancias de VMR.
[in] lpSurface
Especifica la superficie de DirectDraw.
[in] dwSurfaceFlags
Palabra doble que contiene las marcas de superficie. Vea la sección Comentarios.
Valor devuelto
Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, devuelve un código de error.
Comentarios
La única marca que actualmente comprueba VMR es AM_GBF_NOTASYNCPOINT (0x00000002), lo que indica que no va a rellenar este búfer con un punto de sincronización (fotograma clave).
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP con SP1 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | strmif.h (incluye Dshow.h) |
| Library | Strmiids.lib |