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。
如果原始资源在数组大小等于 1 的情况下是有效的图面,则子资源是有效的图面。

注解

子资源表面对象实现 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

另请参阅

IDXGIResource1