共用方式為


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 裝置上使用。 例如,如果搭配 Direct2D 使用表面,則 Direct2D 轉譯目標必須透過 ID2D1Factory::CreateDxgiSurfaceRenderTarget 或在同一裝置上建立的裝置內容建立。

規格需求

需求
最低支援的用戶端 適用於 Windows 7 的 Windows 8 和平臺更新 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 適用於 Windows Server 2008 R2 的 Windows Server 2012 和平臺更新 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 d2d1_1.h
Dll D2d1.dll

另請參閱

ID2D1Bitmap1

ID2D1DeviceContext::CreateBitmap

ID2D1DeviceContext::CreateBitmapFromDxgiSurface

ID2D1RenderTarget::CreateSharedBitmap