IDCompositionVisual::SetContent 方法 (dcomp.h)
将此视觉对象的 Content 属性设置为指定的位图或窗口包装器。
语法
HRESULT SetContent(
[in, optional] IUnknown *content
);
参数
[in, optional] content
类型: IUnknown*
此视觉对象的新内容的对象。 此参数可以为 NULL。
返回值
类型: HRESULT
如果函数成功,则返回S_OK。 否则,将返回 HRESULT 错误代码。 有关 错误代码的列表,请参阅 DirectComposition 错误代码 。
注解
content 参数必须指向以下项之一:
- 实现 IDCompositionSurface 接口的 对象。
- 实现 IDXGISwapChain1 接口的 对象。
- 由 CreateSurfaceFromHandle 或 CreateSurfaceFromHwnd 方法返回的包装器对象。
视觉对象可以与位图对象或窗口包装器相关联。 位图是 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 |
另请参阅
IDXGIFactory2::CreateSwapChain1