IDXGIDevice：：CreateSurface 方法 (dxgi.h)

项目
08/23/2023

返回图面。此方法在内部使用，不应在应用程序中直接调用它。

语法

HRESULT CreateSurface(
  [in]           const DXGI_SURFACE_DESC    *pDesc,
                 UINT                       NumSurfaces,
                 DXGI_USAGE                 Usage,
  [in, optional] const DXGI_SHARED_RESOURCE *pSharedResource,
  [out]          IDXGISurface               **ppSurface
);

参数

[in] pDesc

类型： const DXGI_SURFACE_DESC*

指向描述图面的DXGI_SURFACE_DESC 结构的指针。

NumSurfaces

类型： UINT

要创建的图面数。

Usage

类型： DXGI_USAGE

一个DXGI_USAGE标志，用于指定预期如何使用图面。

[in, optional] pSharedResource

类型： const DXGI_SHARED_RESOURCE*

指向 DXGI_SHARED_RESOURCE 结构的可选指针，该结构包含用于打开此类资源的视图的共享资源信息。

[out] ppSurface

类型： IDXGISurface**

指向第一个创建图面的 IDXGISurface 接口指针的地址。

返回值

类型： HRESULT

如果成功，则返回S_OK;否则为错误代码。有关错误代码的列表，请参阅 DXGI_ERROR。

备注

CreateSurface 方法创建一个缓冲区，用于在一个或多个设备之间交换数据。它在内部使用，不应直接调用它。

运行时在创建表示图面的 Direct3D 资源对象时自动创建 IDXGISurface 接口。例如，运行时在调用 ID3D11Device：：CreateTexture2D 或 ID3D10Device：：CreateTexture2D 来创建 2D 纹理时创建 IDXGISurface 接口。若要检索表示 2D 纹理图 面的 IDXGISurface 接口，请调用 ID3D11Texture2D：：QueryInterface 或 ID3D10Texture2D：：QueryInterface。在此调用中，必须传递 IDXGISurface 的标识符。如果 2D 纹理只有一个 MIP 贴图级别且不包含纹理数组， 则 QueryInterface 将成功并返回指向 IDXGISurface 接口指针的指针。否则， QueryInterface 会失败，并且不会返回指向 IDXGISurface 的指针。