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

Artigo
08/23/2023

Retorna uma superfície. Esse método é usado internamente e você não deve chamá-lo diretamente em seu aplicativo.

Sintaxe

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*

Um ponteiro para uma estrutura DXGI_SURFACE_DESC que descreve a superfície.

NumSurfaces

Tipo: UINT

O número de superfícies a serem criadas.

Usage

Tipo: DXGI_USAGE

Um sinalizador DXGI_USAGE que especifica como a superfície deve ser usada.

[in, optional] pSharedResource

Tipo: const DXGI_SHARED_RESOURCE*

Um ponteiro opcional para uma estrutura DXGI_SHARED_RESOURCE que contém informações de recursos compartilhados para abrir exibições desses recursos.

[out] ppSurface

Tipo: IDXGISurface**

O endereço de um ponteiro de interface IDXGISurface para a primeira superfície criada.

Valor retornado

Tipo: HRESULT

Retorna S_OK se tiver êxito; caso contrário, um código de erro. Para obter uma lista de códigos de erro, consulte DXGI_ERROR.

Comentários

O método CreateSurface cria um buffer para trocar dados entre um ou mais dispositivos. Ele é usado internamente e você não deve chamá-lo diretamente.

O runtime cria automaticamente uma interface IDXGISurface quando cria um objeto de recurso Direct3D que representa uma superfície. Por exemplo, o runtime cria uma interface IDXGISurface quando chama ID3D11Device::CreateTexture2D ou ID3D10Device::CreateTexture2D para criar uma textura 2D. Para recuperar a interface IDXGISurface que representa a superfície de textura 2D, chame ID3D11Texture2D::QueryInterface ou ID3D10Texture2D::QueryInterface. Nesta chamada, você deve passar o identificador de IDXGISurface. Se a textura 2D tiver apenas um único nível de mapa MIP e não consistir em uma matriz de texturas, QueryInterface terá êxito e retornará um ponteiro para o ponteiro da interface IDXGISurface . Caso contrário, QueryInterface falhará e não retornará o ponteiro para IDXGISurface.