ID2D1Bitmap1：：GetSurface 方法 (d2d1_1.h)
获取创建位图时指定的图面，或在创建位图时创建的默认图面。
语法
HRESULT GetSurface(
[out, optional] IDXGISurface **dxgiSurface
);
参数
[out, optional] dxgiSurface
类型： IDXGISurface**
位图的基础 DXGI 图面。
返回值
类型： HRESULT
该方法返回 HRESULT。 可能的值包括（但并不限于）下表中的项。
| HRESULT | 说明 |
|---|---|
| S_OK | 未发生错误。 |
| D2DERR_BITMAP_BOUND_AS_TARGET | 不能使用当前绑定为目标位图的位图进行绘制。 |
注解
使用的位图必须已从 DXGI 表面呈现目标、派生的呈现目标或从 ID2D1Device 创建的设备上下文创建。
返回的图面可以与 Microsoft Direct3D 或任何其他与共享图面互操作的 API 一起使用。 应用程序必须以传递方式确保此图面可在此上下文中使用的 Direct3D 设备上使用。 例如，如果将 Surface 与 Direct2D 配合使用，则 Direct2D 呈现目标必须通过 ID2D1Factory：：CreateDxgiSurfaceRenderTarget 或在同一设备上创建的设备上下文上创建。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 适用于 Windows 7 的Windows 8和平台更新 [桌面应用 |UWP 应用] |
| 最低受支持的服务器 | 适用于 Windows Server 2008 R2 的Windows Server 2012和平台更新 [桌面应用 |UWP 应用] |
| 目标平台 | Windows |
| 标头 | d2d1_1.h |
| DLL | D2d1.dll |
另请参阅
ID2D1DeviceContext：：CreateBitmap