ID2D1RenderTarget::CreateCompatibleRenderTarget(constD2D1_SIZE_F*,constD2D1_SIZE_U*,constD2D1_PIXEL_FORMAT*,D2D1_COMPATIBLE_RENDER_TARGET_OPTIONS,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(
  const D2D1_SIZE_F                     *desiredSize,
  const D2D1_SIZE_U                     *desiredPixelSize,
  const D2D1_PIXEL_FORMAT               *desiredFormat,
  D2D1_COMPATIBLE_RENDER_TARGET_OPTIONS options,
  ID2D1BitmapRenderTarget               **bitmapRenderTarget
);

Parámetros

desiredSize

Tipo: [in] const 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] const 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] const 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.

options

Tipo: [in] D2D1_COMPATIBLE_RENDER_TARGET_OPTIONS

Un valor que especifica si el nuevo destino de representación debe ser compatible con GDI.

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.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	d2d1.h
Library	D2d1.lib
Archivo DLL	D2d1.dll

Consulte también

ID2D1RenderTarget