ICGetState(3mms) — Subroutines
Name
ICGetState --- Obtain current state of a compressor or decompressor
Syntax
#include <mme/mme_api.h>
void ICGetState(HIC hic,
LPVOID pv,
DWORD cb);
Arguments
HIC hic
Specifies a handle to a compressor or decompressor.
LPVOID pv
Specifies a pointer to a buffer used to return the state data. The data structure must be allocated with the mmeAllocMem function before being passed to the ICGetState function.
DWORD cb
Specifies the size (in bytes) of the state data buffer.
Description
The ICGetState function obtains the current state of a compressor or decompressor. Use the ICGetStateSize function before calling the ICGetState function to determine the size of the buffer to allocate for the call.
See the Multimedia Services for Digital UNIX Programmer’s Guide, Section 7.8, for information about controlling the amount of compression in the Software Indeo CODEC.
Extensions
None.
Return Values
Returns the current state of the device if the function is successful; otherwise, it returns the following error code:
ICERR_BADHANDLE@T{ The hic argument is invalid or the compressor or decompressor is not open. T}