Skip to main content
Retorna a forma de um único bloco de recurso em blocos para o formato especificado.

Sintaxe

Parâmetros

Dimension _In_
Tipo: XG_RESOURCE_DIMENSION
A dimensão do recurso como uma constante de enumeração XG_RESOURCE_DIMENSION, como para desconhecido, buffer, textura 1D, textura 2D ou textura 3D. Format _In_
Tipo: XG_FORMAT
O formato como uma constante de enumeração XG_FORMAT, como XG_FORMAT_R32G32B32_UINT.
  • Se Format for XG_FORMAT_UNKNOWN, o parâmetro BytesPerElement será usado em seu lugar, e BytesPerElement deverá ser 1, 2, 4, 8 ou 16 bytes.
  • Se Format não for XG_FORMAT_UNKNOWN, o valor de BytesPerElement será ignorado e calculado por esta função.
BytesPerElement _In_
Tipo: UINT32
Os bytes por elemento, como um UINT32. SampleCount _In_
Tipo: UINT32
Para todas as dimensões de recurso diferentes de Texture2D, SampleCount deve ser 1. Para Texture2D, SampleCount deve ser 1, 2, 4 ou 8. pTileShapeInTexels _Out_opt_
Tipo: XG_TILE_SHAPE*
A forma do bloco, em texels, como um ponteiro para uma estrutura XG_TILE_SHAPE. Se Format for XG_FORMAT_UNKNOWN, pTileShapeInTexels será preenchido com zeros, se estiver presente. pTileShapeInElements _Out_opt_
Tipo: XG_TILE_SHAPE_ELEMENTS*
A forma do bloco, em elementos, como um ponteiro para uma estrutura XG_TILE_SHAPE_ELEMENTS.

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

Esta função retorna a forma de um único bloco de recurso em blocos para o formato especificado. A forma do bloco é retornada em unidades de texels e também de elementos.

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