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 |