MÉTHODE ID2D1Factory ::CreateWicBitmapRenderTarget(IWICBitmap*,constD2D1_RENDER_TARGET_PROPERTIES*,ID2D1RenderTarget**) (d2d1.h)

Crée une cible de rendu qui s’affiche dans une bitmap de composant d’acquisition d’images Microsoft Windows (WIC).

Syntaxe

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

Paramètres

[in] target

Type : IWICBitmap*

Bitmap qui reçoit la sortie de rendu de la cible de rendu.

[in] renderTargetProperties

Type : const D2D1_RENDER_TARGET_PROPERTIES*

Le mode de rendu, le format des pixels, les options de communication à distance, les informations DPI et la prise en charge minimale de DirectX requise pour le rendu matériel. Pour plus d’informations sur les formats de pixels pris en charge, consultez Formats de pixels pris en charge et Modes Alpha.

[out] renderTarget

Type : ID2D1RenderTarget**

Lorsque cette méthode retourne, contient l’adresse du pointeur vers l’objet ID2D1RenderTarget créé par cette méthode.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, il retourne un code d’erreur HRESULT .

Remarques

Vous devez utiliser D2D1_FEATURE_LEVEL_DEFAULT pour le membre minLevel du paramètre renderTargetProperties avec cette méthode.

Votre application doit créer des cibles de rendu une seule fois et les conserver pendant toute la durée de vie de l’application ou jusqu’à ce que l’erreur D2DERR_RECREATE_TARGET soit reçue. Lorsque vous recevez cette erreur, vous devez recréer la cible de rendu (et toutes les ressources qu’elle a créées).

Notes

Cette méthode n’est pas prise en charge sur Windows Phone et échoue lorsqu’elle est appelée sur un appareil avec le code d’erreur 0x8899000b (« Aucun périphérique de rendu matériel n’est disponible pour cette opération »). Étant donné que l’émulateur Windows Phone prend en charge le rendu WARP, cette méthode échoue lorsqu’elle est appelée sur l’émulateur avec un code d’erreur différent, 0x88982f80 (wincodec_err_unsupportedpixelformat).

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7, Windows Vista avec SP2 et Mise à jour de plateforme pour Windows Vista [applications de bureau | Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 R2, Windows Server 2008 avec SP2 et Mise à jour de plateforme pour Windows Server 2008 [applications de bureau | Applications UWP]
Plateforme cible	Windows
En-tête	d2d1.h
Bibliothèque	D2d1.lib
DLL	D2d1.dll

Voir aussi

ID2D1Factory