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

# D3D12GetInterface (consoles XBOX Series)

> Seleciona uma versão do SDK em tempo de execução quando o sistema está no Modo de Desenvolvedor do Windows.

Seleciona uma versão do SDK em tempo de execução quando o sistema está no Modo de Desenvolvedor do Windows. Dá suporte a interfaces de depuração, ferramentas, [DRED](https://learn.microsoft.com/en-us/windows/win32/direct3d12/use-dred) e configuração do SDK.

## Sintaxe

```cpp theme={null}
HRESULT D3D12GetInterface(
    const IID & rclsid,
    const IID & riid,
    void  ppvDebug
)
```

### Parâmetros

*rclsid*\
Tipo: const IID &

O CLSID associado aos dados e ao código que serão usados para criar o objeto.

Os seguintes CLSIDs são definidos.

* DEFINE\_GUID(CLSID\_D3D12Debug,                        0xf2352aeb, 0xdd84, 0x49fe, 0xb9, 0x7b, 0xa9, 0xdc, 0xfd, 0xcc, 0x1b, 0x4f);
* DEFINE\_GUID(CLSID\_D3D12Tools,                        0xe38216b1, 0x3c8c, 0x4833, 0xaa, 0x09, 0x0a, 0x06, 0xb6, 0x5d, 0x96, 0xc8);
* DEFINE\_GUID(CLSID\_D3D12DeviceRemovedExtendedData,    0x4a75bbc4, 0x9ff4, 0x4ad8, 0x9f, 0x18, 0xab, 0xae, 0x84, 0xdc, 0x5f, 0xf2);
* DEFINE\_GUID(CLSID\_D3D12SDKConfiguration,             0x7cda6aca, 0xa03e, 0x49c8, 0x94, 0x58, 0x03, 0x34, 0xd2, 0x0e, 0x07, 0xce);

Eles correspondem, respectivamente, às seguintes interfaces.

* [Interface ID3D12Debug](https://learn.microsoft.com/en-us/windows/win32/api/d3d12sdklayers/nn-d3d12sdklayers-id3d12debug)
* [Interface ID3D12Tools](/pt-BR/reference/graphics/d3d12/interfaces/id3d12tools/id3d12tools_public)
* [Interface ID3D12DeviceRemovedExtendedDataSettings](/pt-BR/reference/graphics/d3d12/interfaces/id3d12deviceremovedextendeddatasettings/id3d12deviceremovedextendeddatasettings_public)
* [Interface ID3D12SDKConfiguration](https://learn.microsoft.com/en-us/windows/win32/api/d3d12/nn-d3d12-id3d12sdkconfiguration)

*riid*\
Tipo: const IID &

O identificador global exclusivo (**GUID**) da interface de configuração do SDK. O **REFIID**, ou **GUID**, da interface pode ser obtido usando a macro `__uuidof`. Por exemplo, `__uuidof(ID3D12SDKConfiguration)` recuperará o **GUID** da interface de depuração.

*ppvDebug*\
Tipo: void \*\*

O parâmetro `out` que contém a interface solicitada no retorno (por exemplo, a interface de configuração do SDK), como um ponteiro para ponteiro para void. Consulte [Interface ID3D12SDKConfiguration](https://learn.microsoft.com/en-us/windows/win32/api/d3d12/nn-d3d12-id3d12sdkconfiguration).

### Valor retornado

Tipo: HRESULT

Se a função for bem-sucedida, ela retornará **S\_OK**. Caso contrário, retornará um dos [códigos de retorno do Direct3D 12](https://learn.microsoft.com/en-us/windows/win32/direct3d12/d3d12-graphics-reference-returnvalues).

## Comentários

## Requisitos

**Cabeçalho:** d3d12\_xs.h\
**Biblioteca:** d3d12\_xs.lib\
**Plataformas com suporte**: consoles XBOX Series

## Confira também

* [ID3D12Debug](https://learn.microsoft.com/en-us/windows/win32/api/d3d12sdklayers/nn-d3d12sdklayers-id3d12debug)
* [ID3D12Tools](/pt-BR/reference/graphics/d3d12/interfaces/id3d12tools/id3d12tools_public)
* [ID3D12DeviceRemovedExtendedDataSettings](/pt-BR/reference/graphics/d3d12/interfaces/id3d12deviceremovedextendeddatasettings/id3d12deviceremovedextendeddatasettings_public)
* [Interface ID3D12SDKConfiguration](https://learn.microsoft.com/en-us/windows/win32/api/d3d12/nn-d3d12-id3d12sdkconfiguration)


## Related topics

- [ID3D12Device10 (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device10/id3d12device10_public.md)
- [ID3D12Device5 (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device5/id3d12device5_public.md)
- [ID3D12Device9 (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device9/id3d12device9_public.md)
- [ID3D12GraphicsCommandList7 (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist7/id3d12graphicscommandlist7_public.md)
- [D3D12GetDebugInterface](/pt-BR/reference/graphics/d3d12/functions/d3d12getdebuginterface_public.md)