Función ICDraw (vfw.h)

La función ICDraw descomprime una imagen para dibujar.

Sintaxis

DWORD VFWAPIV ICDraw(
  HIC    hic,
  DWORD  dwFlags,
  LPVOID lpFormat,
  LPVOID lpData,
  DWORD  cbData,
  LONG   lTime
);

Parámetros

hic

Controle a un descomprimor.

dwFlags

Marcas de descompresión. Se definen los valores siguientes.

Value	Significado
ICDRAW_HURRYUP	Los datos se almacena en búfer y no se dibujan en la pantalla. Use esta marca para la descompresión más rápida.
ICDRAW_NOTKEYFRAME	El marco actual no es un fotograma clave.
ICDRAW_NULLFRAME	El marco actual no contiene ningún dato y se debe volver a dibujar el marco anterior.
ICDRAW_PREROLL	El fotograma actual del vídeo se produce antes de que se inicie la reproducción. Por ejemplo, si la reproducción comenzará en el fotograma 10 y el fotograma 0 es el fotograma clave más cercano, los fotogramas del 0 al 9 se envían al controlador con la marca ICDRAW_PREROLL establecida. El controlador necesita estos datos para mostrar correctamente el marco 10.
ICDRAW_UPDATE	Novedades la pantalla en función de los datos recibidos anteriormente. Establezca lpData en NULL cuando se use esta marca.

lpFormat

Puntero a una estructura BITMAPINFOHEADER que contiene el formato de entrada de los datos.

lpData

Puntero a los datos de entrada.

cbData

Tamaño de los datos de entrada, en bytes.

lTime

Tiempo, en muestras, para dibujar este marco. Las unidades de los datos de vídeo son fotogramas. Para obtener una definición de la velocidad de reproducción, consulte los miembros dwRate y dwScale de la estructura ICDRAWBEGIN .

Valor devuelto

Devuelve ICERR_OK si se ejecuta correctamente o si se produce un error de otro modo.

Comentarios

Puede iniciar el dibujo de los fotogramas enviando el mensaje de ICM_DRAW_START (o mediante la macro ICDrawStart ). La aplicación debe asegurarse de almacenar en búfer el número necesario de fotogramas antes de iniciar el dibujo. Envíe el mensaje KM_GETBUFFERSWANTED (o use la macro ICGetBuffersWanted ) para obtener este valor.

Requisitos

Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	vfw.h
Library	Vfw32.lib
Archivo DLL	Msvfw32.dll

Consulte también

Funciones de compresión de vídeo

Administrador de compresión de vídeo