Id2D1DeviceContext::CreateBitmapFromDxgiSurface(IDXGISurface*,constD2D1_BITMAP_PROPERTIES1&,ID2D1Bitmap1**) (d2d1_1.h)

  • Artículo

Crea un mapa de bits a partir de una superficie DXGI que se puede establecer como una superficie de destino o tiene especificada información de contexto de color adicional.

Sintaxis

HRESULT CreateBitmapFromDxgiSurface(
  [in]           IDXGISurface                    *surface,
  [in, optional] const D2D1_BITMAP_PROPERTIES1 & bitmapProperties,
  [out]          ID2D1Bitmap1                    **bitmap
);

Parámetros

[in] surface

Tipo: IDXGISurface*

Superficie DXGI desde la que se puede crear el mapa de bits.

Nota La superficie DXGI debe haberse creado a partir del mismo dispositivo Direct3D al que está asociado el contexto del dispositivo Direct2D.
 

[in, optional] bitmapProperties

Tipo: const D2D1_BITMAP_PROPERTIES1*

Propiedades de mapa de bits especificadas además de la superficie.

[out] bitmap

Tipo: ID2D1Bitmap1**

Cuando este método devuelve, contiene la dirección de un puntero a un nuevo objeto de mapa de bits.

Valor devuelto

Tipo: HRESULT

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

HRESULT Descripción
S_OK No se ha producido ningún error.
E_OUTOFMEMORY Direct2D no pudo asignar memoria suficiente para completar la llamada.
E_INVALIDARG Se pasó un valor no válido al método .
D3DERR_OUTOFVIDEOMEMORY Direct3D no tiene suficiente memoria para mostrar para realizar la operación.

Comentarios

Si no se especifican las propiedades del mapa de bits, se asume la siguiente información:

  • El valor de PPP del mapa de bits es 96.
  • El formato de píxel coincide con el de la superficie.
  • El mapa de bits devuelto heredará las marcas de enlace de la superficie DXGI.
    • Sin embargo, solo se heredará el subconjunto de marcas significativos para Direct2D. Por ejemplo, D3D10_USAGE_DYNAMIC no es compatible con ninguna marca pública de Direct2D.
  • Se desconoce el contexto de color.
  • El modo alfa del mapa de bits se premultiplicará (caso común) o recto (A8).
Si se especifican las propiedades del mapa de bits, las propiedades del mapa de bits se usarán de la siguiente manera:
  • Las propiedades del mapa de bits especificarán el PPP del mapa de bits.
  • Si pppX y pppY son 0, el valor de PPP del mapa de bits será 96.
  • El formato de píxel debe ser compatible con la vista de recursos del sombreador o la vista de destino de representación de la superficie.
  • Las opciones de mapa de bits deben ser compatibles con las marcas de enlace de la superficie DXGI. Sin embargo, pueden ser un subconjunto. Esto influirá en las vistas de recursos creadas por el mapa de bits.
  • La información de contexto de color se usará desde las propiedades del mapa de bits, si se especifica.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8 y Actualización de plataforma para Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2012 y actualización de plataforma para Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado d2d1_1.h
Archivo DLL D2d1.dll

Consulte también

D2D1_BITMAP_PROPERTIES1

ID2D1Bitmap1

ID2D1DeviceContext

ID2D1DeviceContext::SetTarget