fpOpenStream()

This function opens a stream for filtering.

DEPRECATED: The fpOpenStream() function is deprecated in KeyView 23.2.0 and later. OpenText recommends that you create a KVDocument to represent each document, by calling fpOpenDocumentFromStream().

You only need to call fpOpenStream() if you want to use deprecated functions, such as fpCanFilterStream() and fpFilterStream(), that require a stream context.

This function is still available for existing implementations, but it might be incompatible with new functionality and might be removed in future.

Syntax

void * pascal fpOpenStream( 
    KVFilterSession   session, 
    KVInputStream    *pInput );

Arguments

session

A Filter session that you initialized by calling fpInit().

pInput A pointer to the developer-assigned instance of KVInputStream. The structure KVInputStream defines the input stream that contains the source.

Returns

Discussion

  • Before you call this function, you must create an input stream either by using the fpFileToInputStreamCreate() function, or by using code similar to the coding example in the Filter sample program.
  • After filtering is complete, call fpCloseStream() to free the memory allocated by this function.