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

# D3D12GetDebugInterface

> Obtém uma interface de depuração.

Obtém uma interface de depuração.

Use [D3D12GetInterface](/pt-BR/reference/graphics/d3d12/functions/d3d12getinterface_public) para acessar diretamente interfaces mais recentes, especialmente em níveis inferiores.

## Sintaxe

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

### Parâmetros

*riid \[in]*\
Tipo: const IID &

O identificador global exclusivo (**GUID**) da interface de depuração.
O **REFIID**, ou **GUID**, da interface de depuração pode ser obtido usando a macro \_\_uuidof().
Por exemplo, \_\_uuidof([ID3D12Debug](https://learn.microsoft.com/en-us/windows/desktop/api/d3d12sdklayers/nn-d3d12sdklayers-id3d12debug)) obterá o **GUID** da interface de depuração.

*ppvDebug \[out, optional]*\
Tipo: void \*\*

A interface de depuração, como um ponteiro para ponteiro para void.
Consulte
[ID3D12Debug](https://learn.microsoft.com/en-us/windows/desktop/api/d3d12sdklayers/nn-d3d12sdklayers-id3d12debug) e
[ID3D12DebugDevice](https://learn.microsoft.com/en-us/windows/desktop/api/d3d12sdklayers/nn-d3d12sdklayers-id3d12debugdevice).

### Valor retornado

Tipo: HRESULT

Este método retorna um dos [Códigos de retorno do Direct3D 12](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/d3d12-graphics-reference-returnvalues).

## Comentários

A assinatura de função PFN\_D3D12\_GET\_DEBUG\_INTERFACE é fornecida como um typedef, para que você possa usar técnicas de vinculação dinâmica ([GetProcAddress](https://learn.microsoft.com/en-us/windows/desktop/api/libloaderapi/nf-libloaderapi-getprocaddress)) em vez de vinculação estática.

#### Exemplos

Habilite a camada de depuração do D3D12.

```cpp theme={null}
// Enable the D3D12 debug layer.
{

ComPtr<ID3D12Debug> debugController;
if (SUCCEEDED(D3D12GetDebugInterface(IID_PPV_ARGS(&debugController))))
{
debugController->EnableDebugLayer();
}
}

```

Consulte o [Código de exemplo na referência do D3D12](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/notes-on-example-code).

<div class="code" />

## Requisitos

**Cabeçalho:** d3d12\_xs.h ou d3d12\_x.h\
**Biblioteca:** d3d12\_xs.lib ou d3d12\_x.lib\
**Plataformas com suporte**: consoles XBOX Series e família XBOX One

## Confira também

[Funções principais](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/direct3d-12-functions)


## Related topics

- [ID3D12DeviceRemovedExtendedDataSettings](/pt-BR/reference/graphics/d3d12/interfaces/id3d12deviceremovedextendeddatasettings/id3d12deviceremovedextendeddatasettings_public.md)
- [D3D12EnableExperimentalFeatures](/pt-BR/reference/graphics/d3d12/functions/d3d12enableexperimentalfeatures_public.md)
- [D3D12GetInterface (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/functions/d3d12getinterface_public.md)
- [SetName](/pt-BR/reference/graphics/d3d12/interfaces/id3d12object/methods/id3d12object_setname_public.md)
- [D3D12_AUTO_BREADCRUMB_NODE](/pt-BR/reference/graphics/d3d12/structs/d3d12_auto_breadcrumb_node_public.md)