Método IGraphConfig::AddFilterToCache (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 AddFilterToCache método agrega un filtro a la caché de filtros.
Sintaxis
HRESULT AddFilterToCache(
[in] IBaseFilter *pFilter
);
Parámetros
[in] pFilter
Puntero a la interfaz IBaseFilter del filtro.
Valor devuelto
Devuelve uno de los siguientes valores HRESULT .
| Código devuelto | Descripción |
|---|---|
|
Error. |
|
Argumento de puntero NULL. |
|
El filtro ya está en la memoria caché. |
|
El filtro se agregó a la memoria caché. |
Comentarios
Debe desconectar todas las patillas del filtro antes de llamar a este método o se producirá un error en el método. Si el filtro está en el gráfico de filtros, este método lo quitará. Este método también colocará el filtro en un estado detenido, si aún no lo está.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP [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 |