Partager via


CRenderTarget::CreateCompatibleRenderTarget

Crée une nouvelle cible de rendu de l'image bitmap pour une utilisation pendant le dessin hors écran intermédiaire qui est compatible avec la cible de rendu en cours.

BOOL CreateCompatibleRenderTarget(
   CBitmapRenderTarget& bitmapTarget,
   CD2DSizeF sizeDesired = CD2DSizeF(0.,
   0.),
   CD2DSizeU sizePixelDesired = CD2DSizeU(0,
   0),
   D2D1_PIXEL_FORMAT* desiredFormat = NULL,
   D2D1_COMPATIBLE_RENDER_TARGET_OPTIONS options = D2D1_COMPATIBLE_RENDER_TARGET_OPTIONS_NONE
);

Paramètres

  • bitmapTarget
    À son retour, la fonction contient l'adresse d'un pointeur à une nouvelle cible de rendu de l'image bitmap. Ce paramètre est passé sans être initialisé.

  • sizeDesired
    Taille souhaitée de la nouvelle cible de rendu en pixels indépendants du périphérique si elle doit être différente de la cible de rendu d'origine, ou NULL. Pour plus d'informations, consultez la section Notes.

  • sizePixelDesired
    Taille souhaitée de la nouvelle cible de rendu en pixels si elle doit être différente de la cible de rendu d'origine, ou NULL. Pour plus d'informations, consultez la section Notes.

  • desiredFormat
    Format de pixel et mode alpha souhaités pour la nouvelle cible de rendu, ou NULL. Si le format de pixel a la valeur DXGI_FORMAT_UNKNOWN ou si ce paramètre est null, la nouvelle cible de rendu utilise le même format de pixel comme cible de rendu d'origine. Si le mode alpha est D2D1_ALPHA_MODE_UNKNOWN ou que ce paramètre est NULL, le mode alpha de la nouvelle cible de rendu a pour valeur par défaut D2D1_ALPHA_MODE_PREMULTIPLIED. Pour plus d'informations sur les formats de pixels pris en charge, reportez-vous à la section sur les formats de pixels pris en charge et les modes alpha.

  • options
    Valeur qui indique si la nouvelle cible de rendu doit être compatible avec GDI.

Valeur de retour

Si la méthode réussit, renvoie TRUE. Sinon, renvoie la valeur FALSE.

Configuration requise

En-tête : afxrendertarget.h

Voir aussi

Référence

Classe CRenderTarget