> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CreateSurface (consoles XBOX Series)

> Retorna uma superfície.

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

## Sintaxe

```cpp theme={null}
HRESULT CreateSurface(  
         const DXGI_SURFACE_DESC *pDesc,  
         UINT NumSurfaces,  
         DXGI_USAGE Usage,  
         const DXGI_SHARED_RESOURCE* pSharedResource,  
         IDXGISurface** ppSurface  
)  
```

### Parâmetros

\**pDesc*   \_In\_\
Tipo: DXGI\_SURFACE\_DESC

Um ponteiro para uma estrutura [DXGI\_SURFACE\_DESC](https://learn.microsoft.com/en-us/windows/win32/api/dxgi/ns-dxgi-dxgi_surface_desc) que descreve a superfície.

*NumSurfaces*   \_In\_\
Tipo: UINT

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

*Usage*   \_In\_\
Tipo: DXGI\_USAGE

Um sinalizador [DXGI\_USAGE](https://learn.microsoft.com/en-us/windows/win32/direct3ddxgi/dxgi-usage) que especifica como a superfície deve ser usada.

*pSharedResource*   \_In\_opt\_\
Tipo: DXGI\_SHARED\_RESOURCE\*

Representa um identificador [DXGI\_SHARED\_RESOURCE](https://learn.microsoft.com/en-us/windows/win32/api/dxgi/ns-dxgi-dxgi_shared_resource) para um recurso compartilhado.

*ppSurface*   \_Out\_\
Tipo: IDXGISurface\*\*

O endereço de um ponteiro de interface [IDXGISurface](https://learn.microsoft.com/en-us/windows/win32/api/dxgi/nn-dxgi-idxgisurface) para a primeira superfície criada.

### Valor retornado

Tipo: HRESULT

Retorna S\_OK se bem-sucedido; caso contrário, retorna um código de erro. Para obter uma lista de códigos de erro, consulte [Códigos de retorno do Direct3D 12](https://learn.microsoft.com/en-us/windows/win32/direct3d12/d3d12-graphics-reference-returnvalues).

## Requisitos

**Cabeçalho:** d3d12\_xs.h

**Biblioteca:** d3d12\_xs.lib\
**Plataformas com suporte**: consoles XBOX Series

## Confira também

[IDXGIDevice](/pt-BR/reference/graphics/d3d12_xs/interfaces/IDXGIDevice/idxgidevice)


## Related topics

- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [CreateHeap1 (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device4/methods/id3d12device4_createheap1_public.md)
- [CreatePlacedResource2 (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device10/methods/id3d12device10_createplacedresource2_public.md)
- [CreateReservedResource2 (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device10/methods/id3d12device10_createreservedresource2_public.md)
- [CreateMetaCommand (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device5/methods/id3d12device5_createmetacommand_public.md)