IDXGIDevice::CreateSurface, méthode (dxgi.h)

Article
08/23/2023

Retourne une surface. Cette méthode est utilisée en interne et vous ne devez pas l’appeler directement dans votre application.

Syntaxe

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

Paramètres

[in] pDesc

Type : const DXGI_SURFACE_DESC*

Pointeur vers une structure DXGI_SURFACE_DESC qui décrit la surface.

NumSurfaces

Type : UINT

Nombre de surfaces à créer.

Usage

Type : DXGI_USAGE

Indicateur DXGI_USAGE qui spécifie la façon dont la surface est censée être utilisée.

[in, optional] pSharedResource

Type : const DXGI_SHARED_RESOURCE*

Pointeur facultatif vers une structure de DXGI_SHARED_RESOURCE qui contient des informations de ressources partagées pour ouvrir des vues de ces ressources.

[out] ppSurface

Type : IDXGISurface**

Adresse d’un pointeur d’interface IDXGISurface vers la première surface créée.

Valeur retournée

Type : HRESULT

Retourne S_OK en cas de réussite ; un code d’erreur dans le cas contraire. Pour obtenir la liste des codes d’erreur, consultez DXGI_ERROR.

Notes

La méthode CreateSurface crée une mémoire tampon pour échanger des données entre un ou plusieurs appareils. Il est utilisé en interne et vous ne devez pas l’appeler directement.

Le runtime crée automatiquement une interface IDXGISurface lorsqu’il crée un objet de ressource Direct3D qui représente une surface. Par exemple, le runtime crée une interface IDXGISurface lorsqu’il appelle ID3D11Device::CreateTexture2D ou ID3D10Device::CreateTexture2D pour créer une texture 2D. Pour récupérer l’interface IDXGISurface qui représente la surface de texture 2D, appelez ID3D11Texture2D::QueryInterface ou ID3D10Texture2D::QueryInterface. Dans cet appel, vous devez passer l’identificateur d’IDXGISurface. Si la texture 2D n’a qu’un seul niveau de carte MIP et ne se compose pas d’un tableau de textures, QueryInterface réussit et retourne un pointeur vers le pointeur d’interface IDXGISurface . Sinon, QueryInterface échoue et ne retourne pas le pointeur vers IDXGISurface.