Método IDXGIDevice::CreateSurface (dxgi.h)

Artículo
08/23/2023

Devuelve una superficie. Este método se usa internamente y no debe llamarlo directamente en la aplicación.

Sintaxis

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

Parámetros

[in] pDesc

Tipo: const DXGI_SURFACE_DESC*

Puntero a una estructura de DXGI_SURFACE_DESC que describe la superficie.

NumSurfaces

Tipo: UINT

Número de superficies que se van a crear.

Usage

Tipo: DXGI_USAGE

Marca DXGI_USAGE que especifica cómo se espera que se use la superficie.

[in, optional] pSharedResource

Tipo: const DXGI_SHARED_RESOURCE*

Puntero opcional a una estructura de DXGI_SHARED_RESOURCE que contiene información de recursos compartidos para abrir vistas de dichos recursos.

[out] ppSurface

Tipo: IDXGISurface**

Dirección de un puntero de interfaz IDXGISurface a la primera superficie creada.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se ejecuta correctamente; de lo contrario, un código de error. Para obtener una lista de códigos de error, consulte DXGI_ERROR.

Comentarios

El método CreateSurface crea un búfer para intercambiar datos entre uno o varios dispositivos. Se usa internamente y no debe llamarlo directamente.

El tiempo de ejecución crea automáticamente una interfaz IDXGISurface cuando crea un objeto de recurso de Direct3D que representa una superficie. Por ejemplo, el tiempo de ejecución crea una interfaz IDXGISurface cuando llama a ID3D11Device::CreateTexture2D o ID3D10Device::CreateTexture2D para crear una textura 2D. Para recuperar la interfaz IDXGISurface que representa la superficie de textura 2D, llame a ID3D11Texture2D::QueryInterface o ID3D10Texture2D::QueryInterface. En esta llamada, debe pasar el identificador de IDXGISurface. Si la textura 2D tiene solo un nivel de mapa MIP y no consta de una matriz de texturas, QueryInterface se realiza correctamente y devuelve un puntero al puntero de interfaz IDXGISurface . De lo contrario, QueryInterface produce un error y no devuelve el puntero a IDXGISurface.