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

Sintaxe

Parâmetros

pDesc _In_
Tipo: XG_TEXTURE1D_DESC*
A descrição de uma textura 1D como um ponteiro para uma estrutura XG_TEXTURE1D_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.

Comentários

Use esta função de conveniência em vez de criar um computador de textura quando você só precisar calcular um layout e não precisar usar nenhum dos outros recursos de um computador de textura. Esta função cria internamente um computador de textura, chama o método XGTextureAddressComputer::GetResourceLayout e, em seguida, libera o computador de textura. Se qualquer um dos seguintes casos ocorrer, a função retornará E_INVALIDARG:
  • Se pDesc ou pLayout forem nulos.
  • Se XG_TEXTURE1D_DESC.Usage for XG_USAGE_DYNAMIC. Recursos offline não podem ter uso dinâmico.
  • Se XG_TEXTURE1D_DESC.Pitch não for 0.
  • Se XG_TEXTURE1D_DESC.Usage for XG_USAGE_STAGING e XG_TEXTURE1D_DESC.TileMode não for XG_TILE_MODE_LINEAR. Somente modos de disposição em blocos lineares têm suporte com recursos de preparo.
  • Se os sinalizadores de XG_TEXTURE1D_DESC não forem válidos.

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