Compartir a través de


ID2D1Factory::CreateDxgiSurfaceRenderTarget(IDXGISurface*,constD2D1_RENDER_TARGET_PROPERTIES&,ID2D1RenderTarget**) (d2d1.h)

Crea un destino de representación que se dibuja en una superficie de Infraestructura de gráficos DirectX (DXGI).

Sintaxis

HRESULT CreateDxgiSurfaceRenderTarget(
  [in]  IDXGISurface                          *dxgiSurface,
  [ref] const D2D1_RENDER_TARGET_PROPERTIES & renderTargetProperties,
  [out] ID2D1RenderTarget                     **renderTarget
);

Parámetros

[in] dxgiSurface

Tipo: IDXGISurface*

IdXGISurface al que se dibujará el destino de representación.

[ref] renderTargetProperties

Tipo: const D2D1_RENDER_TARGET_PROPERTIES &

El modo de representación, el formato de píxeles, las opciones de comunicación remota, la información de PPP y la compatibilidad mínima con DirectX que se necesita para la representación de hardware. Para obtener información sobre los formatos de píxeles admitidos, vea Formatos de píxeles admitidos y Modos alfa.

[out] renderTarget

Tipo: ID2D1RenderTarget**

Cuando este método finaliza, contiene la dirección del puntero al objeto ID2D1RenderTarget creado por este método.

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

Para escribir en una superficie de Direct3D, obtienes un IDXGISurface y lo pasas al método CreateDxgiSurfaceRenderTarget para crear un destino de representación de superficie DXGI; A continuación, puedes usar el destino de representación de superficie DXGI para dibujar contenido 2D en la superficie DXGI.

Un destino de representación de superficie DXGI es un tipo de ID2D1RenderTarget. Al igual que otros destinos de representación de Direct2D, puedes usarlo para crear recursos y emitir comandos de dibujo.

El destino de representación de la superficie DXGI y la superficie DXGI deben usar el mismo formato DXGI. Si especifica el formato de DXGI_FORMAT_UNKOWN al crear el destino de representación, usará automáticamente el formato de la superficie.

El destino de representación de superficie DXGI no realiza la sincronización de superficie DXGI.

Para obtener más información sobre cómo crear y usar destinos de representación de superficie DXGI, consulta La introducción a la interoperabilidad de Direct2D y Direct3D.

Para trabajar con Direct2D, el dispositivo Direct3D que proporciona IDXGISurface debe crearse con la marca D3D10_CREATE_DEVICE_BGRA_SUPPORT .

Cuando se crea un destino de representación y la aceleración de hardware está disponible, se asignan recursos en la GPU del equipo. Al crear un destino de representación una vez y conservarlo siempre que sea posible, obtendrá ventajas de rendimiento. La aplicación debe crear destinos de representación una vez y mantenerlos durante la vida útil de la aplicación o hasta que el método EndDraw del destino de representación devuelva el error D2DERR_RECREATE_TARGET . Cuando reciba este error, debe volver a crear el destino de representación (y los recursos que creó).

Ejemplos

Vea el ejemplo de código en ID2D1Factory::CreateDxgiSurfaceRenderTarget.

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

CreateDxgiSurfaceRenderTarget(IDXGISurface,const D2D1_RENDER_TARGET_PROPERTIES,ID2D1RenderTarget)

Introducción a la interoperabilidad de Direct2D y Direct3D

ID2D1Factory