Compartir a través de

Método IVMRSurfaceAllocatorNotify::AdviseSurfaceAllocator (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.

Una AdviseSurfaceAllocator aplicación llama al método para indicar al VMR que use un asignador-moderador personalizado.

Sintaxis

HRESULT AdviseSurfaceAllocator(
  [in] DWORD_PTR            dwUserID,
  [in] IVMRSurfaceAllocator *lpIVRMSurfaceAllocator
);

Parámetros

[in] dwUserID

Una DWORD_PTR definida por la aplicación que identifica de forma única esta instancia de VMR en escenarios en los que se usan varias instancias de VMR con una única instancia de un moderador de asignador.

[in] lpIVRMSurfaceAllocator

Especifica la interfaz IVMRSurfaceAllocator en el nuevo asignador-moderador. Si este valor es NULL, VMR liberará el asignador de cliente-moderador y restaurará su asignador-moderador predeterminado.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, devuelve un código de error.

Comentarios

El método hará que el asignador-moderador predeterminado se desinstale y destruya y reemplace por el nuevo componente especificado. El nuevo componente también debe admitir la interfaz IVMRImagePresenter .

Solo se puede llamar a este método una vez durante la vigencia de VMR. VMR sigue usando el asignador-moderador hasta que se elimine el VMR. Cuando el VMR se libera finalmente, libera su recuento de referencias en el objeto asignador personalizado-moderador, lo que permite que ese objeto se libere.

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 (incluya Dshow.h)
Library Strmiids.lib

Consulte también

Códigos de error y éxito

IVMRSurfaceAllocatorNotify (Interfaz)

Uso del representador de mezcla de vídeos