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