Método IGetFrame::SetFormat (vfw.h)

El método SetFormat establece el formato de imagen descomprimido de los fotogramas que se extraen y, opcionalmente, proporciona un búfer para la operación de descompresión.

Sintaxis

HRESULT SetFormat(
  LPBITMAPINFOHEADER lpbi,
  LPVOID             lpBits,
  int                x,
  int                y,
  int                dx,
  int                dy
);

Parámetros

lpbi

Puntero a una estructura BITMAPINFOHEADER que define el formato de imagen descomprimido. También puede especificar NULL o el valor ((LPBITMAPINFOHEADER) 1) de este parámetro. NULL hace que el descomprimor elija un formato adecuado para su edición (normalmente un formato de profundidad de imagen de 24 bits). El valor ((LPBITMAPINFOHEADER) 1) hace que el descompresión elija un formato adecuado para el modo de visualización actual.

lpBits

Puntero a un búfer para contener los datos de imagen descomprimidos. Especifique NULL para que este método asigne un búfer.

x

Coordenada x del rectángulo de destino dentro del DIB especificado por lpbi. Este parámetro se usa cuando lpBits no es NULL.

y

Coordenada y del rectángulo de destino dentro del DIB especificado por lpbi. Este parámetro se usa cuando lpBits no es NULL.

dx

Ancho del rectángulo de destino. Este parámetro se usa cuando lpBits no es NULL.

dy

Alto del rectángulo de destino. Este parámetro se usa cuando lpBits no es NULL.

Valor devuelto

Devuelve NOERROR si se ejecuta correctamente, E_OUTOFMEMORY si la imagen descomprimida es mayor que el tamaño del búfer o E_FAIL de lo contrario.

Comentarios

Los parámetros x, y, dx y dy identifican la parte del mapa de bits especificado por lpbi y lpBits que recibe la imagen descomprimida.

En el caso de los controladores escritos en C++, SetFormat tiene la sintaxis siguiente:

HRESULT SetFormat(LPBITMAPINFOHEADER lpbi, LPVOID lpBits, int x, 
    int y, int dx, int dy); 
 

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

Consulte también

Interfaces de controlador de secuencias y archivos personalizados

Controladores de archivos y secuencias personalizados