ID2D1RenderTarget::CreateCompatibleRenderTarget(D2D1_SIZE_F,D2D1_SIZE_U,D2D1_PIXEL_FORMAT,ID2D1BitmapRenderTarget**) (d2d1.h)

Crea un destino de representación de mapa de bits para su uso durante el dibujo fuera de pantalla intermedio que es compatible con el destino de representación actual.

Sintaxis

HRESULT CreateCompatibleRenderTarget(
  D2D1_SIZE_F             desiredSize,
  D2D1_SIZE_U             desiredPixelSize,
  D2D1_PIXEL_FORMAT       desiredFormat,
  ID2D1BitmapRenderTarget **bitmapRenderTarget
);

Parámetros

desiredSize

Tipo: [in] D2D1_SIZE_F

Tamaño deseado del nuevo destino de representación (en píxeles independientes del dispositivo), si debe ser diferente del destino de representación original. Para obtener más información, consulta la sección Comentarios.

desiredPixelSize

Tipo: [in] D2D1_SIZE_U

Tamaño deseado del nuevo destino de representación en píxeles si debe ser diferente del destino de representación original. Para obtener más información, vea la sección Comentarios.

desiredFormat

Tipo: [in] D2D1_PIXEL_FORMAT

Formato de píxel deseado y modo alfa del nuevo destino de representación. Si el formato de píxel se establece en DXGI_FORMAT_UNKNOWN, el nuevo destino de representación usa el mismo formato de píxel que el destino de representación original. Si el modo alfa está D2D1_ALPHA_MODE_UNKNOWN, el modo alfa del nuevo destino de representación tiene como valor predeterminado D2D1_ALPHA_MODE_PREMULTIPLIED. Para obtener información sobre los formatos de píxeles admitidos, vea Formatos de píxeles admitidos y Modos alfa.

bitmapRenderTarget

Tipo: [out] ID2D1BitmapRenderTarget**

Cuando este método vuelve, contiene un puntero a un puntero a un nuevo destino de representación de mapa de bits. Este parámetro se pasa sin inicializar.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error HRESULT .

Comentarios

El tamaño de píxel y ppp del nuevo destino de representación se pueden modificar especificando valores para desiredSize o desiredPixelSize.

• Si se especifica desiredSize , pero desiredPixelSize no es, el tamaño de píxel se calcula a partir del tamaño deseado mediante el VALOR de PPP de destino primario. Si desiredSize se asigna a un tamaño de píxel entero, el valor de PPP del destino de representación compatible es el mismo que el ppp del destino primario. Si desiredSize se asigna a un tamaño de píxel fraccionado, el tamaño de píxel se redondea hasta el entero más cercano y el valor de PPP para el destino de representación compatible es ligeramente superior al PPP del destino de representación primario. En todos los casos, la coordenada (desiredSize.width, desiredSize.height) se asigna a la esquina inferior derecha del destino de representación compatible.
• Si se especifica desiredPixelSize y desiredSize no es, el valor de PPP del nuevo destino de representación es el mismo que el destino de representación original.
• Si se especifican desiredSize y desiredPixelSize , se calcula el PPP del nuevo destino de representación para tener en cuenta la diferencia en la escala.
• Si no se especifica desiredSize ni desiredPixelSize , el nuevo tamaño de destino de representación y PPP coinciden con el destino de representación original.

El destino de representación de mapa de bits creado por este método no es compatible con GDI.

Requisitos

Requisito	Value
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	d2d1.h
Library	D2d1.lib
Archivo DLL	D2d1.dll

Consulte también

ID2D1RenderTarget