Id2D1RenderTarget::CreateCompatibleRenderTarget(D2D1_SIZE_F,D2D1_SIZE_U,D2D1_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(
D2D1_SIZE_F desiredSize,
D2D1_SIZE_U desiredPixelSize,
D2D1_PIXEL_FORMAT desiredFormat,
D2D1_COMPATIBLE_RENDER_TARGET_OPTIONS options,
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.
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 |
---|---|
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
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de