Partager via


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,
  [ref] 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.

[ref] 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