fpGetOutputImageInfos()

This function returns the image information context that must be supplied to the fpGetOutputImageCount() or fpGetOutputImageInfo() functions. See fpGetOutputImageCount() and fpGetOutputImageInfo().

You must free the system resources associated with this context after you use it, by using the fpFreeImageInfos() function.

Syntax

void* pascal fpGetOutputImageInfos (
      void* const pContext,
      KVInputStream* const pInput,
      KVXMLOptions* const pOptions)

Arguments

pContext

A pointer to a KeyView Export session that you initialized by calling fpInit().

pInput The pointer to a KVInputStream instance. This instance defines the input stream that the function processes to extract the images.
pOptions

A pointer to a KVXMLOptions data structure. Functions using the context obtained with this method will report the dimensions of the images which would be obtained if this options structure were used for XML export. See KVXMLOptions.

This pointer must not be NULL.

Returns

  • If the call is successful, the return value is the pointer to an image info context object.

  • If the call is unsuccessful, the return value is NULL.

Discussion

  • To obtain image information out of process, call KVXMLStartOOPSession() before you call fpGetOutputImageInfos(). You must open a new, second OOP session for any subsequent XML export from the input stream.
  • If this function fails, you can call fpGetKvErrorCode() to help identify the cause of the failure.
  • You can use multiple image info contexts at any one time.