Skip to main content
Calcula o layout de hardware para uma textura 2D.

​
Sintaxe

​
Parâmetros

pDesc _In_
Tipo: XG_TEXTURE2D_DESC* A descrição de uma textura 2D como um ponteiro para uma estrutura XG_TEXTURE2D_DESC. pLayout _Out_
Tipo: XG_RESOURCE_LAYOUT* O layout de hardware como um ponteiro para uma estrutura XG_RESOURCE_LAYOUT.

​
Valor retornado

Tipo: HRESULT Retornará S_OK se tiver êxito; caso contrário, retornará um código de erro. Para obter uma lista de códigos de erro, confira Códigos de erro. Retorna E_INVALIDARG nos seguintes casos:
  • pDesc ou pLayout é nulo.
  • XG_TEXTURE2D_DESC.Usage é XG_USAGE_DYNAMIC. Recursos offline não podem ter uso dinâmico.
  • XG_TEXTURE2D_DESC.Pitch não é 0.
  • XG_TEXTURE2D_DESC.Usage é XG_USAGE_STAGING e XG_TEXTURE2D_DESC.TileMode não é XG_TILE_MODE_LINEAR. Somente modos de disposição em blocos lineares têm suporte com recursos de preparo.
  • Os sinalizadores de XG_TEXTURE2D_DESC são inválidos.

​
Comentários

Se você só precisar calcular um layout e não precisar usar nenhum outro recurso de um computador de textura, não crie um computador de textura; use esta função de conveniência. A função cria internamente um computador de textura, chama o método XGTextureAddressComputer::GetResourceLayout e, em seguida, libera o computador de textura.

​
Requisitos

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

​
Confira também

Referência do XG
Last modified on October 6, 2026