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

# XGTextureAddressComputer::GetTexelElementOffsetBytes

> XGTextureAddressComputer::GetTexelElementOffsetBytes (XBOX Series 主機)：計算位移 (以 (請參閱 xgtextureaddresscomputer_gettexelelementoffsetbytes)

計算指定紋素元素相對於資源基底位址的位移 (以位元組為單位)。

<a id="syntaxSection" />

## 語法

```cpp theme={null}
UINT64 GetTexelElementOffsetBytes(
         UINT32 Plane,
         UINT32 MipLevel,
         UINT64 X,
         UINT32 Y,
         UINT32 ZOrSlice,
         UINT32 Sample
)  
```

<a id="ID4EU" />

### 參數

*Plane*   \_In\_\
類型：UINT32

平面。

*MipLevel*   \_In\_\
類型：UINT32

mip 層級。

*X*   \_In\_\
類型：UINT64

紋素元素的 x 座標。

*Y*   \_In\_\
類型：UINT32

紋素元素的 y 座標。

*ZOrSlice*   \_In\_\
類型：UINT32

Z 或切片。

*Sample*   \_In\_\
類型：UINT32

要開始複製之取樣的索引，通常為零。如果此參數大於或等於取樣計數，此函式會傳回錯誤。

<a id="ID4E4" />

### 傳回值

類型：UINT64

如果呼叫成功，傳回值為指定紋素元素相對於資源基底位址的位移 (以位元組為單位)。

下列任一情況都會導致錯誤，並傳回 -1 值 (0xffffffffffffffff，即 UINT64 的最大值)：

* plane 參數大於或等於紋理計算器所計算出的平面計數。
* 取樣計數大於或等於紋理計算器所計算出的取樣數目。
* 紋理計算器所計算出的平面用途旗標為 XG\_PLANE\_USAGE\_COLOR\_MASK、XG\_PLANE\_USAGE\_FRAGMENT\_MASK、XG\_PLANE\_USAGE\_HTILE 或 XG\_PLANE\_USAGE\_UNUSED。

<a id="requirements" />

## 需求

**標頭：** xg.h

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

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

<a id="ID4EVC" />

## 另請參閱

[XGTextureAddressComputer](/zh-TW/reference/graphics/xg__NR/interfaces/XGTextureAddressComputer/xgtextureaddresscomputer)\
[XG 參考](/zh-TW/reference/graphics/xg__NR/xg_members)


## Related topics

- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr-CA/nda/nda-topic-directory.md)
- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [Directorio de temas NDA: enlaces activos a Microsoft Learn](/es/nda/nda-topic-directory.md)
- [NDA 토픽 디렉터리 - Microsoft Learn 라이브 링크](/ko/nda/nda-topic-directory.md)
- [NDA 主题目录 - Microsoft Learn 在线链接](/zh-CN/nda/nda-topic-directory.md)