Skip to main content
Calcula o deslocamento (em bytes) do elemento texel especificado, a partir do endereço base do recurso.

Sintaxe

Parâmetros

Plane   _In_
Tipo: UINT32
O plano. MipLevel   _In_
Tipo: UINT32
O nível de mip. X   _In_
Tipo: UINT64
A coordenada x do elemento texel. Y   _In_
Tipo: UINT32
A coordenada y do elemento texel. ZOrSlice   _In_
Tipo: UINT32
O Z OU a fatia. Sample   _In_
Tipo: UINT32
O índice, geralmente zero, da amostra a partir da qual iniciar a cópia. Esta função retornará um erro se este parâmetro for maior ou igual à contagem de amostras.

Valor retornado

Tipo: UINT64 Se a chamada for bem-sucedida, o valor retornado será o deslocamento (em bytes) do elemento texel especificado, a partir do endereço base do recurso. Qualquer um dos casos a seguir causará um erro e fará com que o valor -1 (0xffffffffffffffff, o valor máximo de UINT64) seja retornado:
  • O parâmetro plane é maior ou igual à contagem de planos calculada pelo computador de textura.
  • A contagem de amostras é maior ou igual ao número de amostras calculado pelo computador de textura.
  • O sinalizador de uso de plano calculado pelo computador de textura é XG_PLANE_USAGE_COLOR_MASK, XG_PLANE_USAGE_FRAGMENT_MASK, XG_PLANE_USAGE_HTILE ou XG_PLANE_USAGE_UNUSED.

Requisitos

Cabeçalho: xg.h Biblioteca: xg_x.lib Plataformas com suporte: família XBOX One

Confira também

XGTextureAddressComputer
Referência do XG
Última modificação em 6 de outubro de 2026