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

# CreateComponentPlacedResourceX2 (XBOX Series 主機)

> CreateComponentPlacedResourceX2 (XBOX Series 主機) — 放置資源的元件 (子資源)。適用於 XBOX 的 Direct3D 12 圖形參考。

放置資源的元件 (子資源)。

## 語法

```cpp theme={null}
HRESULT CreateComponentPlacedResourceX2(  
         const D3D12XBOX_COMPONENT_PLACED_ADDRESSES* pComponentLocations,  
         const D3D12_RESOURCE_DESC1* pDesc,  
         D3D12_BARRIER_LAYOUT InitialLayout,  
         const D3D12_CLEAR_VALUE* pOptimizedClearValue,  
         REFIID riid,  
         void** ppvResource  
)  
```

### 參數

*pComponentLocations*   \_In\_<br />類型：[D3D12XBOX\_COMPONENT\_PLACED\_ADDRESSES\*](/zh-TW/reference/graphics/d3d12_x/structs/d3d12xbox_component_placed_addresses)

元件位置，以 **D3D12XBOX\_COMPONENT\_PLACED\_ADDRESSES** 結構表示。

*pDesc*   \_In\_<br />類型：[D3D12\_RESOURCE\_DESC1\*](https://learn.microsoft.com/en-us/windows/desktop/api/d3d12/ns-d3d12-d3d12_resource_desc1)

資源或子資源的描述，以 **D3D12\_RESOURCE\_DESC1** 結構的指標表示。

*InitialLayout*   <br />類型：D3D12\_BARRIER\_LAYOUT

紋理資源的初始配置；緩衝區則為 **D3D12\_BARRIER\_LAYOUT::D3D12\_BARRIER\_LAYOUT\_UNDEFINED**。

*pOptimizedClearValue*   \_In\_opt\_<br />類型：[D3D12\_CLEAR\_VALUE\*](https://learn.microsoft.com/en-us/windows/desktop/api/d3d12/ns-d3d12-d3d12_clear_value)

用於清除元件的最佳化值，以 **D3D12\_CLEAR\_VALUE** 結構的指標表示。

*riid*   <br />類型：REFIID

資源介面 [ID3D12Resource](https://learn.microsoft.com/en-us/windows/desktop/api/d3d12/nn-d3d12-id3d12resource) 的全域唯一識別碼 (GUID)。

若要擷取資源介面的 [REFIID](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-oaut/bbde795f-5398-42d8-9f59-3613da03c318) (或 GUID)，請使用 [\_\_uuidof()](https://learn.microsoft.com/en-us/cpp/cpp/uuidof-operator?view=vs-2019) 巨集。例如，若要取得命令清單介面的 GUID，請執行下列動作：

```cpp theme={null}
__uuidof(ID3D12Resource)  
```

*ppvResource*   \_Outptr\_opt\_<br />類型：void\*\*

資源。

### 傳回值

類型：HRESULT

其中一個 [Direct3D 12 傳回碼](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/d3d12-graphics-reference-returnvalues)。

## 備註

使用 **CreateComponentPlacedResourceX2**，在執行階段建立可使用 [XG 程式庫](/zh-TW/reference/graphics/xg__NR/xg_members) 預先處理的離線與放置資源。**XG 程式庫**會提供 FMask 和 CMask 設定的配置。

**CreateComponentPlacedResourceX2** 與 [CreatePlacedResourceX1](/zh-TW/reference/graphics/d3d12_xs/interfaces/ID3D12Device11/methods/id3d12device11_createplacedresourcex1) 類似，但允許遊戲指定最多四個不同的虛擬位址，以代表資源的個別部分。

不同於 [CreateComponentPlacedResourceX1](/zh-TW/reference/graphics/d3d12_x/interfaces/id3d12device/methods/id3d12device_createcomponentplacedresourcex1)，此方法採用 [D3D12\_RESOURCE\_DESC1](https://learn.microsoft.com/en-us/windows/desktop/api/d3d12/ns-d3d12-d3d12_resource_desc1)，以允許使用取樣器回饋 mip 區域。

## 需求

**標頭：** d3d12\_xs.h<br />**程式庫：** d3d12\_xs.lib<br />**支援的平台：** XBOX Series 主機

## 另請參閱

[ID3D12Device11](/zh-TW/reference/graphics/d3d12_xs/interfaces/ID3D12Device11/id3d12device11)

[CreateComponentPlacedResourceX](/zh-TW/reference/graphics/d3d12_x/interfaces/id3d12device/methods/id3d12device_createcomponentplacedresourcex)

[CreateComponentPlacedResourceX1](/zh-TW/reference/graphics/d3d12_x/interfaces/id3d12device/methods/id3d12device_createcomponentplacedresourcex1)

[CreatePlacedResourceX1](/zh-TW/reference/graphics/d3d12_xs/interfaces/ID3D12Device11/methods/id3d12device11_createplacedresourcex1)


## Related topics

- [CreatePlacedResource2 (XBOX Series 主機)](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device10/methods/id3d12device10_createplacedresource2_public.md)
- [CreateProtectedResourceSession (XBOX Series 主機)](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device4/methods/id3d12device4_createprotectedresourcesession_public.md)
- [CreatePlacedResource](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createplacedresource_public.md)
- [CreateReservedResource2 (XBOX Series 主機)](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device10/methods/id3d12device10_createreservedresource2_public.md)
- [CreateReservedResource1 (XBOX Series 主機)](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device4/methods/id3d12device4_createreservedresource1_public.md)