ICCompressQuery(3mms) — Subroutines
Name
ICCompressQuery --- Determine if a compressor can compress a specific format
Syntax
#include <mme/mme_api.h>
MMRESULT ICCompressQuery(HIC hic,
LPBITMAPINFOHEADER lpbiInput,
LPBITMAPINFOHEADER lpbiOutput);
Arguments
HIC hic
Specifies a handle to a compressor.
LPBITMAPINFOHEADER lpbiInput
Specifies a pointer to a BITMAPINFOHEADER data structure indicating the input data.
The BITMAPINFOHEADER data structure must be allocated with the mmeAllocMem function before being passed to the ICCompressQuery 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 indicating the format of the data output. If NULL, then any output format is acceptable.
The BITMAPINFOHEADER data structure must be allocated with the mmeAllocMem function before being passed to the ICCompressQuery function.
See the mmeAllocMem(3mms) reference page for more information about allocating memory for data structures.
Description
The ICCompressQuery function determines if a compressor can compress a specific format.
Extensions
None.
Return Values
Returns ICERR_OK if the compression is supported; 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}