Método ICaptureGraphBuilder::ControlStream (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.
Sintaxis
HRESULT ControlStream(
[in] const GUID *pCategory,
[in] IBaseFilter *pFilter,
[in] REFERENCE_TIME *pstart,
[in] REFERENCE_TIME *pstop,
[in] WORD wStartCookie,
[in] WORD wStopCookie
);
Parámetros
[in] pCategory
Puntero a un GUID que especifica la categoría de patillas de salida. Vea Anclar conjunto de propiedades para obtener una lista de todas las categorías de patillas. Este valor no puede ser NULL.
[in] pFilter
Puntero a una interfaz IBaseFilter en el filtro que se va a controlar. Especificar controles NULL todos los filtros de captura en el gráfico. Recibirá una notificación para cada filtro de captura.
[in] pstart
Puntero a la hora de inicio de la captura. NULL significa empezar ahora. MAX_TIME significa cancelar la solicitud anterior o realizar ninguna acción si no hay ninguna solicitud anterior.
[in] pstop
Puntero al tiempo de detención de la captura. NULL significa detener ahora. MAX_TIME significa cancelar la solicitud anterior o realizar ninguna acción si no hay ninguna solicitud anterior.
[in] wStartCookie
Especifica un valor determinado que se va a enviar cuando se produce el inicio.
[in] wStopCookie
Especifica un valor determinado que se va a enviar cuando se produce la detención.
Valor devuelto
Devuelve S_FALSE si se envía la notificación de detención antes de que se represente el último ejemplo enviado por el filtro de captura; de lo contrario, devuelve S_OK.
Si este método devuelve S_FALSE, es posible que la aplicación quiera esperar antes de detener el gráfico de filtros para permitir que todas las muestras pasen por el gráfico y se representen. De lo contrario, es posible que se pierdan muestras.
Si no hay patillas que coincidan con la descripción que proporcione o si no se puede admitir el control de secuencia en todos los pines indicados, esta función devolverá un código de error.
Observaciones
Use este método para la captura precisa de fotogramas o para el control individual de captura y vista previa. Por ejemplo, podría desactivar la escritura de la imagen capturada en el disco si solo quiere obtener una vista previa de la imagen capturada.
Este método usa la interfaz IAMStreamControl en las patillas.
Este método envía una notificación para cada filtro encontrado con un pin de la categoría especificada.
Requisitos
| Plataforma de destino | Windows |
| Encabezado | strmif.h (incluya Dshow.h) |