ICCompressGetFormat(3mms) — Subroutines
Name
ICCompressGetFormat --- Determine the default output of a compressor
Syntax
#include <mme/mme_api.h>
MMRESULT ICCompressGetFormat(HIC hic,
LPBITMAPINFOHEADER lpbiInput,
LPBITMAPINFOHEAER lpbiOutput);
Arguments
HIC hic
Specifies a handle to a compressor.
LPBITMAPINFOHEADER lpbiInput
Specifies a pointer to a BITMAPINFOHEADER data structure indicating the format of the input data.
The BITMAPINFOHEADER data structure must be allocated with the mmeAllocMem function before being passed to the ICCompressGetFormat function.
See the mmeAllocMem(3mms) reference page for more information about allocating memory for data structures.
LPBITMAPINFOHEADER lpbiOutput
Specifies a pointer to a BITMAPINFOHEADER data structure used to return the default output of the compressor.
The BITMAPINFOHEADER data structure must be allocated with the mmeAllocMem function before being passed to the ICCompressGetFormat function.
See the mmeAllocMem(3mms) reference page for more information about allocating memory for data structures.
Description
The ICCompressGetFormat function determines the default output of a compressor.
Extensions
None.
Return Values
Returns the size of the default output format structure in bytes if the function is successful; otherwise, it returns one of the following error codes:
ICERR_BADHANDLE@T{ The hic argument is invalid, the compressor is not open, or the compressor is not open for compression. T} ICERR_BADFORMAT@T{ The lpbiOutput and lpbiInput arguments are not acceptable formats. T}