ID2D1Factory::CreateWicBitmapRenderTarget(IWICBitmap*,constD2D1_RENDER_TARGET_PROPERTIES*,ID2D1RenderTarget**)-Methode (d2d1.h)
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 |