共用方式為


ID2D1RenderTarget::CreateLayer (D2D1_SIZE_F,ID2D1Layer**) 方法 (d2d1.h)

建立圖層資源,可與這個轉譯目標及其相容的轉譯目標搭配使用。 新圖層具有指定的初始大小。

語法

HRESULT CreateLayer(
  D2D1_SIZE_F size,
  ID2D1Layer  **layer
);

參數

size

類型:[in] D2D1_SIZE_F

如果 (0,則指定 0) ,就不會在圖層資源後方建立任何備份存放區。 呼叫 PushLayer 時,圖層資源會配置至最小大小。

layer

類型: [out] ID2D1Layer**

當方法傳回時,包含新圖層指標的指標。 這個參數會以未初始化的狀態傳遞。

傳回值

類型: HRESULT

如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。

備註

不論一開始是否指定大小,圖層都會視需要自動調整大小。

範例

如需如何使用 CreateLayer的範例,請參閱 如何使用圖層裁剪區域 主題。

規格需求

   
最低支援的用戶端 適用于 Windows Vista 的 Windows 7、Windows Vista SP2 和平臺更新 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 d2d1.h
程式庫 D2d1.lib
Dll D2d1.dll

另請參閱

ID2D1RenderTarget

圖層概觀