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