Compartir a través de


Método ID2D1Bitmap1::GetSurface (d2d1_1.h)

Obtiene la superficie que se especificó cuando se creó el mapa de bits o la superficie predeterminada creada cuando se creó el mapa de bits.

Sintaxis

HRESULT GetSurface(
  [out, optional] IDXGISurface **dxgiSurface
);

Parámetros

[out, optional] dxgiSurface

Tipo: IDXGISurface**

Superficie DXGI subyacente para el 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.
D2DERR_BITMAP_BOUND_AS_TARGET No se puede dibujar con un mapa de bits enlazado actualmente como mapa de bits de destino.

Comentarios

El mapa de bits usado debe haberse creado a partir de un destino de representación de superficie DXGI, un destino de representación derivado o un contexto de dispositivo creado a partir de un ID2D1Device.

La superficie devuelta se puede usar con Microsoft Direct3D o con cualquier otra API que interopera con superficies compartidas. La aplicación debe garantizar transitivamente que la superficie se pueda usar en el dispositivo Direct3D que se usa en este contexto. Por ejemplo, si usa la superficie con Direct2D, el destino de representación de Direct2D debe haberse creado a través de ID2D1Factory::CreateDxgiSurfaceRenderTarget o en un contexto de dispositivo creado en el mismo dispositivo.

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

ID2D1Bitmap1

ID2D1DeviceContext::CreateBitmap

ID2D1DeviceContext::CreateBitmapFromDxgiSurface

ID2D1RenderTarget::CreateSharedBitmap