Share via

ID2D1Factory::CreateWicBitmapRenderTarget(IWICBitmap*,constD2D1_RENDER_TARGET_PROPERTIES*,ID2D1RenderTarget**)-Methode (d2d1.h)

  • Artikel

Erstellt ein Renderziel, das in einer WIC-Bitmap (Microsoft Windows Imaging Component) gerendert wird.

Syntax

HRESULT CreateWicBitmapRenderTarget(
  [in]  IWICBitmap                          *target,
  [in]  const D2D1_RENDER_TARGET_PROPERTIES *renderTargetProperties,
  [out] ID2D1RenderTarget                   **renderTarget
);

Parameter

[in] target

Typ: IWICBitmap*

Die Bitmap, die die Renderingausgabe des Renderziels empfängt.

[in] renderTargetProperties

Typ: const D2D1_RENDER_TARGET_PROPERTIES*

Renderingmodus, Pixelformat, Remotingoptionen, DPI-Informationen und die minimale DirectX-Unterstützung, die für das Hardwarerendering erforderlich ist. Informationen zu unterstützten Pixelformaten finden Sie unter Unterstützte Pixelformate und Alphamodi.

[out] renderTarget

Typ: ID2D1RenderTarget**

Wenn diese Methode zurückgibt, enthält die Adresse des Zeigers auf das ID2D1RenderTarget-Objekt , das von dieser Methode erstellt wurde.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Hinweise

Sie müssen D2D1_FEATURE_LEVEL_DEFAULT für den minLevel-Member des renderTargetProperties-Parameters mit dieser Methode verwenden.

Ihre Anwendung sollte Renderziele einmal erstellen und diese für die Lebensdauer der Anwendung oder bis zum Empfang des D2DERR_RECREATE_TARGET-Fehlers behalten. Wenn sie diesen Fehler erhalten, müssen Sie das Renderziel (und alle erstellten Ressourcen) neu erstellen.

Hinweis

Diese Methode wird auf Windows Phone nicht unterstützt und schlägt fehl, wenn sie auf einem Gerät mit Fehlercode 0x8899000b aufgerufen wird ("Für diesen Vorgang ist kein Hardwarerenderinggerät verfügbar"). Da der Windows Phone Emulator WARP-Rendering unterstützt, schlägt diese Methode fehl, wenn sie im Emulator mit einem anderen Fehlercode aufgerufen wird, 0x88982f80 (wincodec_err_unsupportedpixelformat).

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile d2d1.h
Bibliothek D2d1.lib
DLL D2d1.dll

Weitere Informationen

ID2D1Factory