IDXGIResource1::CreateSubresourceSurface 方法 (dxgi1_2.h)
创建子资源图面对象。
语法
HRESULT CreateSubresourceSurface(
UINT index,
[out] IDXGISurface2 **ppSurface
);
参数
index
要枚举的子资源图面对象的索引。
[out] ppSurface
指向 IDXGISurface2 接口的指针的地址,该接口表示在 index 参数指定的位置创建的子资源 surface 对象。
返回值
如果成功,则返回S_OK;否则,返回以下值之一:
- 如果 索引不在范围或子资源不是有效图面,则DXGI_ERROR_INVALID_CALL。
- 如果内存不足,无法创建子资源 surface 对象,则E_OUTOFMEMORY。
注解
子资源表面对象实现 IDXGISurface2 接口,该接口继承自 IDXGISurface1 和间接 IDXGISurface。 因此,如果原始资源接口对象是使用 GDI 互操作标志创建的,则 IDXGISurface1 的 GDI 互操作方法 (D3D11_RESOURCE_MISC_GDI_COMPATIBLE) 。
CreateSubresourceSurface 创建基于调用 CreateSubresourceSurface 的资源接口的子资源图面。 例如,如果原始资源接口对象是 2D 纹理,则创建的子资源图面也是 2D 纹理。
可以使用 CreateSubresourceSurface 创建立体声资源的各个部分,以便可以在立体声资源的左侧或右侧使用 Direct2D。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 适用于 Windows 7 的Windows 8和平台更新 [桌面应用 |UWP 应用] |
最低受支持的服务器 | 适用于 Windows Server 2008 R2 的Windows Server 2012和平台更新 [桌面应用 |UWP 应用] |
目标平台 | Windows |
标头 | dxgi1_2.h |
Library | Dxgi.lib |