> ## 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 (XBOX One 系列)

> D3D12XboxCreateDevice (XBOX One 系列主機) — 建立代表顯示配接器的裝置。適用於 XBOX 的 Direct3D 12 圖形參考。

在 XBOX 上建立代表顯示配接器的裝置。

## 語法

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

### 參數

*pAdapter*   \_In\_opt\_\
類型：IGraphicsUnknown\*

建立裝置時要使用之視訊配接器的指標。若要使用預設配接器，請設定為 **NULL**。

*pParameters*   \_In\_\
類型：[D3D12XBOX\_CREATE\_DEVICE\_PARAMETERS\*](/zh-TW/reference/graphics/d3d12_x/structs/d3d12xbox_create_device_parameters)

[D3D12XBOX\_CREATE\_DEVICE\_PARAMETERS](/zh-TW/reference/graphics/d3d12_x/structs/d3d12xbox_create_device_parameters) 結構的指標，此結構包含用來建立裝置的參數。

*riid*   \_In\_\
類型：REFIID

裝置介面的全域唯一識別碼 (GUID)。

*ppDevice*   \_Outptr\_opt\_\
類型：void\*\*

記憶體區塊的指標，此記憶體區塊會接收裝置的指標。

### 傳回值

類型：HRESULT

如果成功，則傳回 S\_OK；否則傳回錯誤碼。

在下列情況下傳回 E\_NOINTERFACE：

* 如果 *pAdapter* 未指定 **ID3D12Device**
* 如果無法為裝置建立配接器

如果 *pParameters* 為 Null 指標，則傳回 E\_INVALIDARG。

## 備註

在 XBOX 上，針對 Microsoft Game Development Kit (GDK) 建置的遊戲不支援標準 Direct3D 12。若要為 DirectX 12.X 建立 Direct3D 12 裝置，請使用 **D3D12XboxCreateDevice** 方法。

若要取得要傳遞給 *riid* 和 *ppDevice* 的物件，請使用 [IID\_PPV\_ARGS](https://learn.microsoft.com/en-us/windows/win32/api/combaseapi/nf-combaseapi-iid_ppv_args) 巨集。

## 需求

**標頭：** d3d12\_x.h

**程式庫：** d3d12\_x.lib

**支援的平台：** XBOX One 系列

## 另請參閱

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


## Related topics

- [ID3D12DeviceChild](/zh-CN/reference/graphics/d3d12/interfaces/id3d12devicechild/id3d12devicechild_public.md)
- [ID3D12Device1](/zh-CN/reference/graphics/d3d12/interfaces/id3d12device1/id3d12device1_public.md)
- [ID3D12Device4](/zh-CN/reference/graphics/d3d12/interfaces/id3d12device4/id3d12device4_public.md)
- [ID3D12Device2](/zh-CN/reference/graphics/d3d12/interfaces/id3d12device2/id3d12device2_public.md)
- [NDA 主題目錄 - Microsoft Learn 線上連結](/zh-TW/nda/nda-topic-directory.md)