Compartir a través de

ID2D1DeviceContext::CreateBitmap(D2D1_SIZE_U,constvoid*,UINT32,constD2D1_BITMAP_PROPERTIES1&,ID2D1Bitmap1**) (d2d1_1.h)

  • Artículo

Crea un mapa de bits que se puede usar como superficie de destino, para volver a leer la CPU o como origen para las API DrawBitmap e ID2D1BitmapBrush . Además, la información de contexto de color se puede pasar al mapa de bits.

Sintaxis

HRESULT CreateBitmap(
                 D2D1_SIZE_U                     size,
  [in, optional] const void                      *sourceData,
                 UINT32                          pitch,
  [in]           const D2D1_BITMAP_PROPERTIES1 & bitmapProperties,
  [out]          ID2D1Bitmap1                    **bitmap
);

Parámetros

size

Tipo: D2D1_SIZE_U

Tamaño de píxel del mapa de bits que se va a crear.

[in, optional] sourceData

Tipo: const void*

Datos iniciales que se cargarán en el mapa de bits.

pitch

Tipo: UINT32

El tono de los datos de origen, si se especifica.

[in] bitmapProperties

Tipo: const D2D1_BITMAP_PROPERTIES1*

Propiedades del mapa de bits que se va a crear.

[out] bitmap

Tipo: ID2D1Bitmap1**

Cuando este método vuelve, 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 suficiente memoria 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

El nuevo mapa de bits se puede usar como destino para SetTarget si se crea con D2D1_BITMAP_OPTIONS_TARGET.

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

D2D1_SIZE_U

ID2D1Bitmap1

ID2D1DeviceContext