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

# D3D12CreateDevice (XBOX One 系列)

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

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

## 語法

```cpp theme={null}
HRESULT D3D12CreateDevice(  
         IGraphicsUnknown* pAdapter,  
         D3D_FEATURE_LEVEL MinimumFeatureLevel,  
         REFIID riid,  
         void** ppDevice  
)  
```

### 參數

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

建立[裝置](https://learn.microsoft.com/en-us/windows/win32/direct3d11/overviews-direct3d-11-devices-intro)時要使用之視訊配接器的指標。若要使用預設配接器，請設定為 **NULL**。

*MinimumFeatureLevel*   \
類型：D3D\_FEATURE\_LEVEL

成功建立裝置所需的最低功能層級。

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

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

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

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

### 傳回值

類型：HRESULT

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

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

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

## 備註

在配置圖形記憶體之前，遊戲必須先在核心中初始化圖形記憶體系統。**D3D12CreateDevice** 可讓您建立 Direct3D 12 裝置並配置必要的記憶體。如果遊戲必須在建立 Direct3D 12 裝置之前配置或保留圖形記憶體，您可以使用 **D3DConfigureVirtualMemory** 來初始化圖形記憶體系統。建立 Direct3D 12 裝置相當於使用預設參數呼叫 **D3DConfigureVirtualMemory**。若要取得要傳遞給 *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)\
[D3D\_FEATURE\_LEVEL](https://learn.microsoft.com/en-us/windows/win32/api/d3dcommon/ne-d3dcommon-d3d_feature_level)\
[D3D12XboxCreateDevice](/zh-TW/reference/graphics/d3d12_x/functions/d3d12xboxcreatedevice)\
[Microsoft Game Development Kit 的圖形記憶體概觀](https://learn.microsoft.com/en-us/gaming/gdk/_content/gc/graphics/graphics-memory-overview)


## Related topics

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