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