Fonction RenderTargetProperties (d2d1helper.h)

Crée une structure D2D1_RENDER_TARGET_PROPERTIES .

Syntaxe

D2D1_RENDER_TARGET_PROPERTIES RenderTargetProperties(
       D2D1_RENDER_TARGET_TYPE   type,
  [in] const D2D1_PIXEL_FORMAT & pixelFormat,
       FLOAT                     dpiX,
       FLOAT                     dpiY,
       D2D1_RENDER_TARGET_USAGE  usage,
       D2D1_FEATURE_LEVEL        minLevel
);

Paramètres

type

Type : D2D1_RENDER_TARGET_TYPE

Valeur qui spécifie si la cible de rendu doit utiliser le rendu matériel ou le rendu logiciel. La valeur par défaut, D2D1_RENDER_TARGET_TYPE_DEFAULT, spécifie que le rendu matériel doit être utilisé ; si le rendu matériel n’est pas disponible, la cible de rendu utilise le rendu logiciel. Notez que les cibles de rendu bitmap WIC ne prennent pas en charge le rendu matériel.

[in] pixelFormat

Type : const D2D1_PIXEL_FORMAT

Format de pixel et mode alpha de la cible de rendu. Le format de pixel par défaut est D2D1::P ixelFormat, ce qui indique à Direct2D de sélectionner un format de pixel pris en charge par la cible de rendu. Pour obtenir la liste des formats de pixels et des modes alpha pris en charge par chaque cible de rendu, consultez Formats de pixels pris en charge et Modes alpha.

dpiX

Type : FLOAT

Ppp horizontal de la cible de rendu. La valeur par défaut est 0.0. Si dpiX et dpiY sont définis sur 0,0, la cible de rendu utilise son ppp par défaut. Pour plus d’informations, consultez D2D1_RENDER_TARGET_PROPERTIES.

dpiY

Type : FLOAT

Ppp vertical de la cible de rendu. La valeur par défaut est 0.0. Si dpiX et dpiY sont définis sur 0,0, la cible de rendu utilise son ppp par défaut. Pour plus d’informations, consultez D2D1_RENDER_TARGET_PROPERTIES.

usage

Type : D2D1_RENDER_TARGET_USAGE

Spécifie la façon dont la cible de rendu est rendue à distance et si elle doit être compatible avec GDI. La valeur par défaut, D2D1_RENDER_TARGET_USAGE_NONE, crée une cible de rendu qui n’est pas compatible avec GDI et qui utilise le rendu à distance de flux de commandes Direct3D, s’il est disponible.

minLevel

Type : D2D1_FEATURE_LEVEL

Niveau de fonctionnalité Direct3D minimal requis pour le rendu matériel. La valeur par défaut, D2D1_FEATURE_LEVEL_DEFAULT, indique que Direct2D doit déterminer si le niveau de fonctionnalité Direct3D de l’appareil est adéquat. Ce champ est utilisé uniquement lorsque les objets ID2D1HwndRenderTarget et ID2D1DCRenderTarget sont créés. Pour plus d’informations, consultez D2D1_RENDER_TARGET_PROPERTIES.

Valeur retournée

Type : D2D1_RENDER_TARGET_PROPERTIES

Une D2D1_RENDER_TARGET_PROPERTIES qui contient les paramètres spécifiés.

Spécifications

Voir aussi

D2D1_RENDER_TARGET_PROPERTIES Structure

Formats de pixel et modes alpha pris en charge