KVFilterInitOptions

This structure defines configuration options for a Filter session that you initialize by calling fpInit(). This structure is defined in kvfiltersettings.h.

typedef struct tag_KVFilterInitOptions
{
    KVStructHeader;

    KVCharSet outputCharSet;
    DWORD dwFlags;
} KVFilterInitOptions;

Member Descriptions

KVStructHeader The KeyView version of the structure. See KVStructHead. You must use the macro KVStructInit to initialize the KVStructHead structure.
outputCharSet

The output character set to use when the source character set can be determined from the document or is specified by fpSetSrcCharSet().

The character sets are enumerated in KVCharSet in kvcharset.h. To see which character sets can be used as the target character set, see Coded Character Sets.

dwFlags Instructions on how to process a file or stream. See the following table for more information.

Flags for dwFlags

KVF_CONTENTACCESS Reserved for internal use.
KVF_OUTOFPROCESS Enables out-of-process filtering. This is enabled by default. See The Filter Process Model.
KVF_INPROCESS Enables in-process filtering. See The Filter Process Model.
KVF_HEADERFOOTERTAGS Puts tags around header and footer data.
KVF_HEADERFOOTER Extract headers and footers.
KVF_UNICODEMSBLSB Uses the byte order for Big Endian systems (MSBLSB) for Unicode text. MSBLSB is the "Most Significant Byte Least Significant Byte."
KVF_UNICODELSBMSB Uses the byte order for Little Endian systems (LSBMSB) for Unicode text. LSBMSB is the "Least Significant Byte Most Significant Byte."
KVF_UNICODEMARKER Generates the byte order marker for Unicode text.
KVF_NODEFAULTCHARSETCONVERT Prevents default conversion of document character encoding. See Customize Character Set Detection and Conversion.
KVF_OOPLOGON Enables the out-of-process error log. See Enable or Disable Error Logging.
KVF_OOPLOGOFF Disables the out-of-process error log. See Enable or Disable Error Logging.

KVF_DETECT_OUTOFPROCESS

KVF_DETECT_INPROCESS

These flags specify whether file format detection occurs in-process or out-of-process. These flags override the default_detect_inprocess parameter in formats.ini.

If you set neither of these flags, file detection behavior is determined by the KVF_OUTOFPROCESS or KVF_INPROCESS flags. If you do not set those flags, behavior is determined by default_detect_inprocess in formats.ini.

See Run File Detection In or Out of Process.