dmIC(3dm)                                                            dmIC(3dm)



NAME
     dmICCreate, dmICDestroy - create and destroy image converter context

SYNOPSIS
     #include <dmedia/dmimageconvert.h>

     DMstatus dmICCreate(int i, DMimageconverter *converter);

     void dmICDestroy(DMimageconverter converter);

DESCRIPTION
     dmICCreate creates an image converter context.  The actual selection of
     an image converter is separate from this operation.  The i argument
     specifies the image converter to create and is a value in the range of 0
     to one less than the return value of dmICGetNum. The return value of
     dmICChooseConverter is always valid directly in dmICCreate.

     NOTE: The i value for a given image converter may change at any time.

     The converter argument is the address of a caller supplied data structure
     for for use as a handle in subsequent operations on this image converter
     context.

     A process may have multiple image converters open simultaneously as well
     as multiple contexts of the same image converter.  However, a given image
     converter may itself limit the number of simultaneous open contexts on
     both a per process and per system basis.

     dmICDestroy frees the image converter context.  No further operations are
     valid on this handle.  The caller is responsible for deallocating the
     storage for converter.

SEE ALSO
     dmICGetNum(3dm), dmICGetDescription(3dm), dmICChooseConverter(3dm),
     dmICSetSrcParams(3dm), dmICSetDstParams(3dm), dmICSetConvParams(3dm),
     dmICSetDstPool(3dm), dmICGetDstQueueFD(3dm), dmICSend(3dm),
     dmICReceive(3dm), dmICWork(3dm).


















                                                                        Page 1