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

# XBTCCreateLinearTexture

> 建立線性紋理並為其配置紋理容器。

建立線性紋理並為其配置紋理容器。

## 語法

```cpp theme={null}
HRESULT XBTCCreateLinearTexture(  
         XBTCTextureContainer** ppLinearTexture,  
         XBTC_TEX_DIMENSION Dimension,  
         DXGI_FORMAT Format,  
         size_t Width,  
         size_t Height,  
         size_t DepthOrArraySize,  
         int8_t MipCount  
)  
```

### 參數

*ppLinearTexture*   \_Out\_\
類型：XBTCTextureContainer\*\*

指向 `XBTCTextureContainer` 的指標。

*Dimension*   \_In\_\
類型：[XBTC\_TEX\_DIMENSION](/zh-TW/reference/graphics/xbtc/enums/xbtc_tex_dimension)

從紋理維度列舉中選取的值。

*Format*   \_In\_\
類型：DXGI\_FORMAT

紋理格式 (用於 BCPack)。

*Width*   \_In\_\
類型：size\_t

mip 0 的寬度 (以像素為單位)。

*Height*   \_In\_\
類型：size\_t

mip 0 的高度 (以像素為單位)。

*DepthOrArraySize*   \_In\_\
類型：size\_t

總深度大小或陣列的大小。

*MipCount*   \_In\_\
類型：int8\_t

詳細程度 (LOD) 層級的總數。傳遞 -1 會保留完整的 mip 鏈結。

### 傳回值

類型：HRESULT

如果成功，則傳回 `S_OK`；否則會傳回 HRESULT 錯誤碼。

## 備註

`XBTCCreateLinearTexture` 會建立線性紋理並為其配置紋理容器。
一般紋理排列方式類似於 DirectX DirectDraw Surface (DDS) 檔案。\
在記憶體中，子資源會依遞增順序緊密排列。
就 LOD 索引而言，最大解析度的 mip 層級位於最小解析度之前。
紋理陣列的每個陣列元素都有連續的 mip 鏈結。
如需紋理維度的詳細資訊，請參閱 [XBTC\_TEX\_DIMENSION](/zh-TW/reference/graphics/xbtc/enums/xbtc_tex_dimension)。

## 需求

**標頭:** XBTC.h

**支援的平台**: XBOX One 系列主機與 XBOX Series 主機

## 另請參閱

[XBTC\_TEXTURE\_INFO](/zh-TW/reference/graphics/xbtc/structs/xbtc_texture_info)
[XBTC](/zh-TW/reference/graphics/xbtc/xbtc_members)


## Related topics

- [NDA topic directory - live Microsoft Learn links](/nda/nda-topic-directory.md)
- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [D3D12_FILTER_TYPE](/reference/graphics/d3d12/enums/d3d12_filter_type_public.md)
- [D3D12_FILTER](/reference/graphics/d3d12/enums/d3d12_filter_public.md)
- [CreatePlacedResource](/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createplacedresource_public.md)