Función RenderTargetProperties (d2d1helper.h)

  • Artículo

Crea una estructura D2D1_RENDER_TARGET_PROPERTIES .

Sintaxis

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
);

Parámetros

type

Tipo: D2D1_RENDER_TARGET_TYPE

Valor que especifica si el destino de representación debe usar la representación de hardware o la representación de software. El valor predeterminado, D2D1_RENDER_TARGET_TYPE_DEFAULT, especifica que se usará la representación de hardware; si la representación de hardware no está disponible, el destino de representación usa la representación de software. Tenga en cuenta que los destinos de representación del mapa de bits WIC no admiten la representación de hardware.

[in] pixelFormat

Tipo: const D2D1_PIXEL_FORMAT

Formato de píxel y modo alfa del destino de representación. El formato de píxel predeterminado es D2D1::P ixelFormat, que indica a Direct2D que seleccione un formato de píxel compatible con el destino de representación. Para obtener una lista de formatos de píxeles y modos alfa admitidos por cada destino de representación, consulte Formatos de píxeles admitidos y Modos alfa.

dpiX

Tipo: FLOAT

PPP horizontal del destino de representación. El valor predeterminado es 0.0. Si pppX y pppY se establecen en 0,0, el destino de representación usa su PPP predeterminado. Para obtener más información, consulte D2D1_RENDER_TARGET_PROPERTIES.

dpiY

Tipo: FLOAT

PPP vertical del destino de representación. El valor predeterminado es 0.0. Si pppX y pppY se establecen en 0,0, el destino de representación usa su PPP predeterminado. Para obtener más información, consulte D2D1_RENDER_TARGET_PROPERTIES.

usage

Tipo: D2D1_RENDER_TARGET_USAGE

Especifica cómo se representa el destino de representación de forma remota y si debe ser compatible con GDI. El valor predeterminado, D2D1_RENDER_TARGET_USAGE_NONE, crea un destino de representación que no es compatible con GDI y que usa la representación remota de flujo de comandos de Direct3D, si está disponible.

minLevel

Tipo: D2D1_FEATURE_LEVEL

Nivel de característica de Direct3D mínimo necesario para la representación de hardware. El valor predeterminado, D2D1_FEATURE_LEVEL_DEFAULT, indica que Direct2D debe determinar si el nivel de característica de Direct3D del dispositivo es adecuado. Este campo solo se usa cuando se crean objetos ID2D1HwndRenderTarget e ID2D1DCRenderTarget . Para obtener más información, consulte D2D1_RENDER_TARGET_PROPERTIES.

Valor devuelto

Tipo: D2D1_RENDER_TARGET_PROPERTIES

Una D2D1_RENDER_TARGET_PROPERTIES que contiene la configuración especificada.

Requisitos

   
Cliente mínimo compatible Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado d2d1helper.h
Library D2d1.lib
Archivo DLL D2d1.dll

Consulte también

Estructura de D2D1_RENDER_TARGET_PROPERTIES

Formatos de píxel admitidos y modos alfa