共用方式為


IDCompositionVisual::SetContent 方法 (dcomp.h)

將這個視覺效果的 Content 屬性設定為指定的點陣圖或視窗包裝函式。

語法

HRESULT SetContent(
  [in, optional] IUnknown *content
);

參數

[in, optional] content

類型: IUnknown*

這個視覺效果之新內容的物件。 此參數可以是 NULL。

傳回值

類型: HRESULT

如果函式成功,它會傳回S_OK。 否則,它會傳回 HRESULT 錯誤碼。 如需錯誤碼的清單,請參閱 DirectComposition 錯誤 碼。

備註

content 參數必須指向下列其中一項:

新內容會取代先前與視覺效果相關聯的任何內容。 如果 內容 參數為 NULL,則視覺效果沒有相關聯的內容。

視覺效果可以與位圖物件或窗口包裝函式相關聯。 位圖是 Microsoft DirectX 交換鏈結或 Microsoft DirectComposition 介面。

窗口包裝函式是使用 CreateSurfaceFromHwnd 方法建立的,而且是另一個視窗點陣化的待用視窗,必須是最上層視窗或分層子視窗。 視窗包裝函式在概念上相當於繪製視窗內容的目標視窗大小點陣圖。 這些內容包括目標視窗的子視窗 (分層或) ,以及子視窗中繪製的任何 DirectComposition 內容。

DirectComposition 介面包裝函式是使用 CreateSurfaceFromHandle 方法建立,而且是交換鏈結的參考。 應用程式可能會在跨進程案例中使用表面包裝函式,其中一個進程會建立交換鏈結,而另一個進程會將位圖與視覺效果產生關聯。

位圖一律會繪製在相對於視覺效果座標系統的位置 (0,0) ,不過座標系統會受到 OffsetX、OffsetY 和 Transform 屬性的影響,以及上階視覺效果上的轉換間接影響。 視覺效果的位圖一律會繪製在該視覺效果的子系後面。

規格需求

需求
最低支援的用戶端 Windows 8 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2012 [僅限傳統型應用程式]
目標平台 Windows
標頭 dcomp.h
程式庫 Dcomp.lib
Dll Dcomp.dll

另請參閱

IDCompositionVisual

IDXGIFactory2::CreateSwapChain1