ID2D1DeviceContext2::CreateImageSourceFromWic(IWICBitmapSource*,D2D1_IMAGE_SOURCE_LOADING_OPTIONS,ID2D1ImageSourceFromWic**)-Methode (d2d1_3.h)

Erstellt ein Bildquellobjekt aus einer WIC-Bitmapquelle, während der gesamte Pixelspeicher innerhalb der Bildquelle aufgefüllt wird.
Das Bild wird geladen und gespeichert, während eine minimale Menge an Arbeitsspeicher verwendet wird.

Syntax

HRESULT CreateImageSourceFromWic(
  [in]  IWICBitmapSource                  *wicBitmapSource,
        D2D1_IMAGE_SOURCE_LOADING_OPTIONS loadingOptions,
  [out] ID2D1ImageSourceFromWic           **imageSource
);

Parameter

[in] wicBitmapSource

Typ: IWICBitmapSource*

Die WIC-Bitmapquelle, aus der die Bildquelle erstellt werden soll.

loadingOptions

Typ: D2D1_IMAGE_SOURCE_LOADING_OPTIONS

Optionen zum Erstellen der Bildquelle. Standardoptionen werden verwendet, wenn NULL ist.

[out] imageSource

Typ: ID2D1ImageSourceFromWic**

Empfängt die neue Imagequelle instance.

Rückgabewert

Typ: HRESULT

S_OK, wenn erfolgreich, andernfalls ein HRESULT-Fehler.

Hinweise

Mit dieser Methode wird eine Bildquelle erstellt, die zum Zeichnen des Bilds verwendet werden kann.

Diese Methode unterstützt Bilder, die die maximale Texturgröße überschreiten. Große Bilder werden intern in einem Sparsekachelcache gespeichert.

Diese API unterstützt die gleichen Pixelformate und Alphamodi, die von CreateBitmapFromWicBitmap unterstützt werden.
Wenn die GPU kein bestimmtes Pixelformat unterstützt, gibt diese Methode D2DERR_UNSUPPORTED_PIXEL_FORMAT zurück. Diese Methode wendet keine Anpassungen wie Gamma- oder Alpha-Prämultiplizierung an, die sich auf die Darstellung des Bilds auswirken.

Diese Methode wählt automatisch ein geeignetes Speicherformat aus, um die GPU-Speicherauslastung zu minimieren, z. B. die Verwendung separater Luminanz- und Chrominanztexturen für JPEG-Bilder.

Wenn das Argument loadingOptions NULL ist, verwendet D2D D2D1_IMAGE_SOURCE_LOADING_OPTIONS_NONE.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2016 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	d2d1_3.h
DLL	D2d1.dll

Weitere Informationen

ID2D1DeviceContext2