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