Compartir a través de

Método CBaseControlVideo.GetCurrentImage

  • 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.

El GetCurrentImage método recupera una copia de la imagen actual en el representador.

Sintaxis

HRESULT GetCurrentImage(
   long *pBufferSize,
   long *pVideoImage
);

Parámetros

pBufferSize

Puntero al tamaño del búfer de salida.

pVideoImage

Puntero al búfer de salida de la imagen.

Valor devuelto

Devuelve un valor HRESULT que depende de la implementación; puede ser uno de los siguientes valores u otros valores no enumerados.

Código devuelto Descripción
E_FAIL
 Error.
E_INVALIDARG
 Argumento no válido.
E_OUTOFMEMORY
 Memoria insuficiente Se devuelve cuando el parámetro pVideoInfo es NULL.
NOERROR
 Correcto.
VFW_E_NOT_PAUSED
 No se pudo realizar la operación porque el filtro no está en pausa.

Observaciones

Esta función miembro recupera la imagen del ejemplo y la copia en el búfer de salida. La sección del vídeo copiado en el búfer de salida refleja el rectángulo de origen establecido a través de la interfaz IBasicVideo . No refleja el rectángulo de destino.

Requisitos

Requisito Value
Encabezado
Ctlutil.h (include Streams.h)
Biblioteca
Strmbase.lib (compilaciones comerciales);
Strmbasd.lib (compilaciones de depuración)

Consulte también

CBaseControlVideo (clase)