Edit

D2D1_IMAGE_SOURCE_LOADING_OPTIONS enumeration (d2d1_3.h)

  • Article

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