Edit

Share via

WICPersistOptions enumeration (wincodecsdk.h)

  • Article

Specifies Windows Imaging Component (WIC) options that are used when initializing a component with a stream.

Syntax

typedef enum WICPersistOptions {
  WICPersistOptionDefault = 0,
  WICPersistOptionLittleEndian = 0,
  WICPersistOptionBigEndian = 0x1,
  WICPersistOptionStrictFormat = 0x2,
  WICPersistOptionNoCacheStream = 0x4,
  WICPersistOptionPreferUTF8 = 0x8,
  WICPersistOptionMask = 0xffff
} ;

Constants

 
WICPersistOptionDefault
Value: 0
The default persist options. The default is WICPersistOptionLittleEndian.
WICPersistOptionLittleEndian
Value: 0
The data byte order is little endian.
WICPersistOptionBigEndian
Value: 0x1
The data byte order is big endian.
WICPersistOptionStrictFormat
Value: 0x2
The data format must strictly conform to the specification.

Warning  This option is inconsistently implement and should not be relied on.

 
WICPersistOptionNoCacheStream
Value: 0x4
No cache for the metadata stream.

Certain operations, such as IWICComponentFactory::CreateMetadataWriterFromReader require that the reader have a stream. Therefore, these operations will be unavailable if the reader is initialized with WICPersistOptionNoCacheStream.
WICPersistOptionPreferUTF8
Value: 0x8
Use UTF8 instead of the default UTF16.

Note  This option is currently unused by WIC.

 
WICPersistOptionMask
Value: 0xffff
The WICPersistOptions mask.

Requirements

Requirement Value
Minimum supported client Windows XP with SP2, Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Header wincodecsdk.h

See also

GetPersistOptions