> ## 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.

# D3D12XboxCreateDevice (família XBOX One)

> D3D12XboxCreateDevice (consoles da família XBOX One) — Cria um dispositivo que representa o adaptador de vídeo. Referência de gráficos Direct3D 12 para XBOX.

Cria um dispositivo que representa o adaptador de vídeo em um XBOX.

## Sintaxe

```cpp theme={null}
HRESULT D3D12XboxCreateDevice(  
         IGraphicsUnknown* pAdapter,  
         const D3D12XBOX_CREATE_DEVICE_PARAMETERS* pParameters,  
         REFIID riid,  
         void** ppDevice  
)  
```

### Parâmetros

*pAdapter*   \_In\_opt\_\
Tipo: IGraphicsUnknown\*

Um ponteiro para o adaptador de vídeo a ser usado ao criar um dispositivo. Para usar o adaptador padrão, defina como **NULL**.

*pParameters*   \_In\_\
Tipo: [D3D12XBOX\_CREATE\_DEVICE\_PARAMETERS\*](/pt-BR/reference/graphics/d3d12_x/structs/d3d12xbox_create_device_parameters)

Um ponteiro para uma estrutura [D3D12XBOX\_CREATE\_DEVICE\_PARAMETERS](/pt-BR/reference/graphics/d3d12_x/structs/d3d12xbox_create_device_parameters) que contém os parâmetros a serem usados para criar o dispositivo.

*riid*   \_In\_\
Tipo: REFIID

O identificador global exclusivo (GUID) da interface do dispositivo.

*ppDevice*   \_Outptr\_opt\_\
Tipo: void\*\*

Um ponteiro para um bloco de memória que recebe um ponteiro para o dispositivo.

### Valor retornado

Tipo: HRESULT

Retorna S\_OK se for bem-sucedido; caso contrário, retorna um código de erro.

Retorna E\_NOINTERFACE:

* Se *pAdapter* não especificar um **ID3D12Device**
* Se não for possível criar o adaptador para o dispositivo

Retorna E\_INVALIDARG se *pParameters* for um ponteiro nulo.

## Comentários

O Direct3D 12 padrão não é compatível com jogos criados para o Microsoft Game Development Kit (GDK) no XBOX. Para criar um dispositivo Direct3D 12 para o DirectX 12.X, use o método **D3D12XboxCreateDevice**.

Para obter os objetos a serem passados para *riid* e *ppDevice*, use a macro [IID\_PPV\_ARGS](https://learn.microsoft.com/en-us/windows/win32/api/combaseapi/nf-combaseapi-iid_ppv_args).

## Requisitos

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

**Biblioteca:** d3d12\_x.lib

**Plataformas com suporte:** família XBOX One

## Confira também

[d3d12\_x](/pt-BR/reference/graphics/d3d12_x/d3d12_x_members)\
[D3D12CreateDevice](/pt-BR/reference/graphics/d3d12_x/functions/d3d12createdevice)


## Related topics

- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [Directorio de temas NDA: enlaces activos a Microsoft Learn](/es/nda/nda-topic-directory.md)
- [ID3D12DeviceChild](/es/reference/graphics/d3d12/interfaces/id3d12devicechild/id3d12devicechild_public.md)
- [ID3D12Device1](/es/reference/graphics/d3d12/interfaces/id3d12device1/id3d12device1_public.md)
- [ID3D12Device2](/es/reference/graphics/d3d12/interfaces/id3d12device2/id3d12device2_public.md)