IDCompositionVisual：：SetContent 方法 (dcomp.h)

  • 项目

将此视觉对象的 Content 属性设置为指定的位图或窗口包装器。

语法

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

参数

[in, optional] content

类型： IUnknown*

此视觉对象的新内容的对象。 此参数可以为 NULL。

返回值

类型： HRESULT

如果函数成功，则返回S_OK。 否则，将返回 HRESULT 错误代码。 有关 错误代码的列表，请参阅 DirectComposition 错误代码 。

注解

content 参数必须指向以下项之一：

新内容将替换以前与视觉对象关联的任何内容。 如果 content 参数为 NULL，则视觉对象没有关联的内容。

视觉对象可以与位图对象或窗口包装器相关联。 位图是 Microsoft DirectX 交换链或 Microsoft DirectComposition 图面。

窗口包装器是使用 CreateSurfaceFromHwnd 方法创建的，它是另一个窗口光栅化的备用窗口，该窗口必须是顶级窗口或分层子窗口。 窗口包装器在概念上等效于位图，位图是绘制窗口内容的目标窗口的大小。 内容包括目标窗口的子窗口 (分层或以其他方式) ，以及子窗口中绘制的任何 DirectComposition 内容。

DirectComposition 图面包装器是使用 CreateSurfaceFromHandle 方法创建的，它是对交换链的引用。 应用程序可能会在跨进程方案中使用图面包装器，其中一个进程创建交换链，另一个进程将位图与视觉对象相关联。

位图始终在相对于视觉对象的坐标系 (0,0) 的位置绘制，尽管坐标系直接受 OffsetX、OffsetY 和 Transform 属性的影响，以及间接受上级视觉对象上的转换的影响。 视觉对象的位图始终绘制在该视觉对象的子级后面。

要求

要求 值
最低受支持的客户端 Windows 8 [仅限桌面应用]
最低受支持的服务器 Windows Server 2012 [仅限桌面应用]
目标平台 Windows
标头 dcomp.h
Library Dcomp.lib
DLL Dcomp.dll

另请参阅

IDCompositionVisual

IDXGIFactory2：：CreateSwapChain1