ICM_DECOMPRESS_GET_FORMAT

  • Article

The ICM_DECOMPRESS_GET_FORMAT message requests the output format of the decompressed data from a video decompression driver. You can send this message explicitly or by using the ICDecompressGetFormat macro.

ICM_DECOMPRESS_GET_FORMAT 
wParam = (DWORD) (LPVOID) lpbiInput; 
lParam = (DWORD) (LPVOID) lpbiOutput;

Parameters

lpbiInput

Pointer to a BITMAPINFO structure containing the input format.

lpbiOutput

Pointer to a BITMAPINFO structure to contain the output format. You can specify zero to request only the size of the output format, as in the ICDecompressGetFormatSize macro.

Return Values

If lpbiOutput is zero, returns the size of the structure.

If lpbiOutput is nonzero, returns ICERR_OK if successful or an error otherwise.

Remarks

If lpbiOutput is nonzero, the driver should fill the BITMAPINFO structure with the default output format corresponding to the input format specified for lpbiInput. If the compressor can produce several formats, the default format should be the one that preserves the greatest amount of information.

Requirements

**  Windows NT/2000/XP:** Included in Windows NT 3.1 and later.
**  Windows 95/98/Me:** Included in Windows 95 and later.
**  Header:** Declared in Vfw.h.

See Also

Video Compression Manager, Video Compression Messages, BITMAPINFO, ICDecompressGetFormat, ICDecompressGetFormatSize