Pular para o conteúdo principal
Calcula o deslocamento (em bytes) do elemento de 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 de texel. Y   _In_
Tipo: UINT32
A coordenada y do elemento de texel. ZOrSlice   _In_
Tipo: UINT32
A coordenada Z OU de fatia do elemento de texel. Sample   _In_
Tipo: UINT32
O índice, geralmente zero, da amostra a partir da qual iniciar a cópia. Essa função retorna um erro se esse parâmetro for maior ou igual à contagem de amostras. pBitPosition   _Out_opt_
Tipo: UINT32*
A posição de bit do endereço de texel de saída, no caso de um deslocamento inferior a um byte.

Valor retornado

Tipo: UINT64 Se a chamada tiver êxito, o valor retornado será o deslocamento (em bytes) do elemento de 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 de plano é 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.

Requisitos

Cabeçalho: xg_xs.h Biblioteca: xg_xs.lib
Plataformas com suporte: consoles XBOX Series

Confira também

XGTextureAddressComputer
Última modificação em 6 de outubro de 2026