Filtro de agarrador de ejemplo
[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.
Nota:
[Desusado. Esta API se puede quitar de futuras versiones de Windows.]
El filtro Sample Grabber proporciona una manera de recuperar ejemplos a medida que pasan por el gráfico de filtros. Es un filtro de transformación con un pin de entrada y un pin de salida. Pasa todas las muestras de bajada sin cambios, por lo que puede insertarla en un grafo de filtro sin modificar el flujo de datos. A continuación, la aplicación puede recuperar ejemplos individuales del filtro llamando a métodos en la interfaz ISampleGrabber .
Si desea recuperar ejemplos sin representar los datos, conecte el filtro Sample Grabber al filtro Representador nulo .
| Etiqueta | Value |
|---|---|
| Interfaces de filtro | IBaseFilter, ISampleGrabber |
| Tipos de medios de patillas de entrada | Cualquier tipo de medio. |
| Interfaces de patillas de entrada | IMemInputPin, IPin, IQualityControl |
| Tipos de medios de patillas de salida | Cualquier tipo de medio. Coincide con el tipo de medio de entrada. |
| Interfaces de patillas de salida | IMediaPosition, IMediaSeeking, IPin, IQualityControl |
| Filtrar CLSID | CLSID_SampleGrabber |
| CLSID de página de propiedades | No hay página de propiedades. |
| Ejecutable | Qedit.dll |
| Mérito | MERIT_DO_NOT_USE |
| Categoría de filtro | CLSID_LegacyAmFilterCategory |
Observaciones
Para usar este filtro, agréguelo al gráfico de filtros y llame a ISampleGrabber::SetMediaType con el tipo de medio deseado. Este método especifica el tipo de medio para las conexiones de pin de entrada y salida del filtro. A continuación, conecte el filtro a otros filtros del gráfico.
Si llama a ISampleGrabber::SetBufferSamples con el valor TRUE, el filtro almacena en búfer cada muestra que recibe antes de pasarla de bajada. Llame al método ISampleGrabber::GetCurrentBuffer para recuperar el contenido actual del búfer. Como alternativa, puede llamar a ISampleGrabber::SetCallback para que el filtro invoque una función de devolución de llamada cada vez que reciba un ejemplo.
El filtro tiene las siguientes limitaciones para los formatos de vídeo:
- No admite tipos de vídeo con orientación de arriba abajo ( biHeight negativo).
- No admite la estructura de formato VIDEOINFOHEADER2 (tipo de formato igual a FORMAT_VideoInfo2).
- Rechaza cualquier tipo de vídeo en el que el paso de la superficie no coincida con el ancho del vídeo.
Como resultado, Sample Grabber no se conectará al representador de mezcla de vídeos (VMR) para algunos tipos de vídeo.
Requisitos
| Requisito | Value |
|---|---|
| Encabezado |
|
Consulte también