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

> 디버그 인터페이스를 가져옵니다.

디버그 인터페이스를 가져옵니다.

특히 다운레벨에서 최신 인터페이스에 직접 액세스하려면 [D3D12GetInterface](/reference/graphics/d3d12/functions/d3d12getinterface_public)를 사용하세요.

## 구문

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

### 매개 변수

*riid \[in]*\
형식: const IID &

디버그 인터페이스의 전역 고유 식별자(**GUID**)입니다.
디버그 인터페이스의 **REFIID** 또는 **GUID**는 \_\_uuidof() 매크로를 사용하여 얻을 수 있습니다.
예를 들어, \_\_uuidof([ID3D12Debug](https://learn.microsoft.com/en-us/windows/desktop/api/d3d12sdklayers/nn-d3d12sdklayers-id3d12debug))는 디버그 인터페이스의 **GUID**를 가져옵니다.

*ppvDebug \[out, optional]*\
형식: void \*\*

디버그 인터페이스로, void에 대한 포인터에 대한 포인터입니다.
[ID3D12Debug](https://learn.microsoft.com/en-us/windows/desktop/api/d3d12sdklayers/nn-d3d12sdklayers-id3d12debug) 및
[ID3D12DebugDevice](https://learn.microsoft.com/en-us/windows/desktop/api/d3d12sdklayers/nn-d3d12sdklayers-id3d12debugdevice)를 참조하세요.

### 반환 값

형식: HRESULT

이 메서드는 [Direct3D 12 반환 코드](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/d3d12-graphics-reference-returnvalues) 중 하나를 반환합니다.

## 설명

함수 시그니처 PFN\_D3D12\_GET\_DEBUG\_INTERFACE는 typedef로 제공되므로 정적 링크 대신 동적 링크 기법([GetProcAddress](https://learn.microsoft.com/en-us/windows/desktop/api/libloaderapi/nf-libloaderapi-getprocaddress))을 사용할 수 있습니다.

#### 예제

D3D12 디버그 레이어를 활성화합니다.

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

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

```

[D3D12 참조의 예제 코드](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/notes-on-example-code)를 참조하세요.

<div class="code" />

## 요구 사항

**헤더:** d3d12\_xs.h 또는 d3d12\_x.h\
**라이브러리:** d3d12\_xs.lib 또는 d3d12\_x.lib\
**지원 플랫폼**: XBOX Series 콘솔 및 XBOX One 제품군

## 함께 보기

[핵심 함수](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/direct3d-12-functions)


## Related topics

- [ID3D12DeviceRemovedExtendedDataSettings](/ko/reference/graphics/d3d12/interfaces/id3d12deviceremovedextendeddatasettings/id3d12deviceremovedextendeddatasettings_public.md)
- [D3D12EnableExperimentalFeatures](/ko/reference/graphics/d3d12/functions/d3d12enableexperimentalfeatures_public.md)
- [D3D12GetInterface (XBOX Series 콘솔)](/ko/reference/graphics/d3d12/functions/d3d12getinterface_public.md)
- [SetName](/ko/reference/graphics/d3d12/interfaces/id3d12object/methods/id3d12object_setname_public.md)
- [DSTORAGE_DEBUG](/ko/reference/system/dstorage/enums/dstorage_debug.md)