> ## 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（XBOX Series 主机）

> 当系统处于 Windows 开发者模式时，在运行时选择 SDK 版本。

当系统处于 Windows 开发者模式时，在运行时选择 SDK 版本。支持调试、工具、[DRED](https://learn.microsoft.com/en-us/windows/win32/direct3d12/use-dred) 和 SDK 配置接口。

## 语法

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

### 参数

*rclsid*\
类型：const IID &

与用于创建对象的数据和代码相关联的 CLSID。

定义了以下 CLSID。

* 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);

它们分别对应于以下接口。

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

*riid*\
类型：const IID &

SDK 配置接口的全局唯一标识符 (**GUID**)。可使用 `__uuidof` 宏获取接口的 **REFIID** 或 **GUID**。例如，`__uuidof(ID3D12SDKConfiguration)` 将获得调试接口的 **GUID**。

*ppvDebug*\
类型：void \*\*

`out` 参数，返回时包含所请求的接口（例如 SDK 配置接口），以指向 void 的指针的指针形式。请参阅 [ID3D12SDKConfiguration 接口](https://learn.microsoft.com/en-us/windows/win32/api/d3d12/nn-d3d12-id3d12sdkconfiguration)。

### 返回值

类型：HRESULT

如果函数成功，则返回 **S\_OK**。否则，返回 [Direct3D 12 返回代码](https://learn.microsoft.com/en-us/windows/win32/direct3d12/d3d12-graphics-reference-returnvalues)之一。

## 备注

## 要求

**头文件：** d3d12\_xs.h\
**库：** d3d12\_xs.lib\
**支持的平台**：XBOX Series 主机

## 另请参阅

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


## Related topics

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