IDCompositionDevice：：CreateVisual 方法 (dcomp.h)

  • 發行項

建立新的視覺效果物件。

語法

HRESULT CreateVisual(
  [out] IDCompositionVisual **visual
);

參數

[out] visual

類型： IDCompositionVisual**

新的視覺物件。 此參數不得為 NULL。

傳回值

類型： HRESULT

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

備註

新的視覺物件具有 OffsetX 和 OffsetY 屬性的靜態值為零，而 Transform、Clip 和 Content 屬性則為 NULL。 一開始，視覺效果不會造成視窗的內容變更。 視覺效果必須新增為另一個視覺效果的子系，或做為組合目標的根目錄，才能影響窗口的外觀。

範例

如需範例，請參閱 如何建置簡單的可視化樹狀結構。

規格需求

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

另請參閱

IDCompositionDevice

IDCompositionTarget：：SetRoot

IDCompositionVisual：：AddVisual