Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

ICCompress(3mms)

ICCompressGetFormat(3mms)

ICCompressQuery(3mms)

ICCompressGetSize(3mms)  —  Subroutines

 
 
 
 

Name

 
ICCompressGetSize --- Obtain the maximum data buffer size that is expected to be used for the compressed data
 
 

Syntax

 
 
 

 #include <mme/mme_api.h>
 MMRESULT ICCompressGetSize(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 format of the input data. 

 
The BITMAPINFOHEADER data structure must be allocated with the mmeAllocMem function before being passed to the ICCompressGetSize 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 output format. 

 
The BITMAPINFOHEADER data structure must be allocated with the mmeAllocMem function before being passed to the ICCompressGetSize function. 
 
 
 
 
See the mmeAllocMem(3mms) reference page for more information about allocating memory for data structures. 
 
 
 
 

Description

 
The ICCompressGetSize function obtains the maximum data buffer size in bytes that is expected to be used for the compressed data. 
 

Extensions

 
None.
 
 

Return Values

 
Returns the maximum data buffer size expected to be used 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}

 
 
 

See Also

 
 
 
 
 
ICCompress(3mms), ICCompressGetFormat(3mms), ICCompressQuery(3mms)
 
 
 
 

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026