D2D1_IMAGE_SOURCE_LOADING_OPTIONS enumeration (d2d1_3.h)

Controls option flags for a new ID2D1ImageSource when it is created.

Syntax

typedef enum D2D1_IMAGE_SOURCE_LOADING_OPTIONS {
  D2D1_IMAGE_SOURCE_LOADING_OPTIONS_NONE = 0,
  D2D1_IMAGE_SOURCE_LOADING_OPTIONS_RELEASE_SOURCE = 1,
  D2D1_IMAGE_SOURCE_LOADING_OPTIONS_CACHE_ON_DEMAND = 2,
  D2D1_IMAGE_SOURCE_LOADING_OPTIONS_FORCE_DWORD = 0xffffffff
} ;

Constants

D2D1_IMAGE_SOURCE_LOADING_OPTIONS_NONE Value: 0 No options are used.
D2D1_IMAGE_SOURCE_LOADING_OPTIONS_RELEASE_SOURCE Value: 1 Indicates the image source should release its reference to the WIC bitmap source after it has initialized. By default, the image source retains a reference to the WIC bitmap source for the lifetime of the object to enable quality and speed optimizations for printing. This option disables that optimization.
D2D1_IMAGE_SOURCE_LOADING_OPTIONS_CACHE_ON_DEMAND Value: 2 Indicates the image source should only populate subregions of the image cache on-demand. You can control this behavior using the EnsureCached and TrimCache methods. This options provides the ability to improve memory usage by only keeping needed portions of the image in memory. This option requires that the image source has a reference to the WIC bitmap source, and is incompatible with D2D1_IMAGE_SOURCE_LOADING_OPTIONS_RELEASE_SOURCE.
D2D1_IMAGE_SOURCE_LOADING_OPTIONS_FORCE_DWORD Value: 0xffffffff

Remarks

D2D1_IMAGE_SOURCE_CREATION_OPTIONS_RELEASE_SOURCE causes the image source to not retain a reference to the source object used to create it.
It can decrease the quality and efficiency of printing.

Requirements

Requirement	Value
Minimum supported client	Windows 10 [desktop apps | UWP apps]
Minimum supported server	Windows Server 2016 [desktop apps | UWP apps]
Header	d2d1_3.h