Метод ID3D12Device::GetResourceTiling (d3d12.h)

Получает сведения о том, как плитка ресурса разбивается на плитки.

Синтаксис

void GetResourceTiling(
  [in]                ID3D12Resource           *pTiledResource,
  [out, optional]     UINT                     *pNumTilesForEntireResource,
  [out, optional]     D3D12_PACKED_MIP_INFO    *pPackedMipDesc,
  [out, optional]     D3D12_TILE_SHAPE         *pStandardTileShapeForNonPackedMips,
  [in, out, optional] UINT                     *pNumSubresourceTilings,
  [in]                UINT                     FirstSubresourceTilingToGet,
  [out]               D3D12_SUBRESOURCE_TILING *pSubresourceTilingsForNonPackedMips
);

Параметры

[in] pTiledResource

Тип: ID3D12Resource*

Указывает плитку ID3D12Resource для получения сведений.

[out, optional] pNumTilesForEntireResource

Тип: UINT*

Указатель на переменную, которая получает количество плиток, необходимых для хранения всего ресурса плитки.

[out, optional] pPackedMipDesc

Тип: D3D12_PACKED_MIP_INFO*

Указатель на структуру D3D12_PACKED_MIP_INFO , которая заполняет GetResourceTiling сведениями о том, как упакованы mipmapы ресурса плитки.

[out, optional] pStandardTileShapeForNonPackedMips

Тип: D3D12_TILE_SHAPE*

Указывает D3D12_TILE_SHAPE структуру, которая GetResourceTiling заполняет сведения о фигуре плитки. Это информация о том, как пиксели помещаются в плитки, независимо от размеров ресурса плитки, не включая упакованные MIP-карты. Если весь ресурс плитки упакован, этот параметр не имеет смысла, так как ресурс с плитками не имеет определенного макета для упакованных MIP-карт. В этой ситуации GetResourceTiling задает элементы D3D12_TILE_SHAPE равным нулю.

[in, out, optional] pNumSubresourceTilings

Тип: UINT*

Указатель на переменную, содержащую количество плиток в подресурсе. Во входных данных это число подресурсов для запроса на плитки; в выходных данных это число, которое фактически было получено в pSubresourceTilingsForNonPackedMips (зажато к доступным).

[in] FirstSubresourceTilingToGet

Тип: UINT

Индекс первой плитки подресурса для получения. GetResourceTiling игнорирует этот параметр, если число, на которое указывает pNumSubresourceTilings , равное 0.

[out] pSubresourceTilingsForNonPackedMips

Тип: D3D12_SUBRESOURCE_TILING*

Указывает структуру D3D12_SUBRESOURCE_TILING , заполняющую GetResourceTiling сведениями о плитках подресурса. Если плитки subresource являются частью упакованных MIP-карт, GetResourceTiling устанавливает элементы D3D12_SUBRESOURCE_TILING на нули, за исключением элемента StartTileIndexInoverallResourceResource , который GetResourceTiling задает значение D3D12_PACKED_TILE (0xffffffff). Константа D3D12_PACKED_TILE указывает, что вся структура D3D12_SUBRESOURCE_TILING бессмысленна для этой ситуации, а сведения о том, что применяется параметр pPackedMipDesc .

Возвращаемое значение

Никакой

Замечания

Чтобы оценить общий размер ресурсов текстур, необходимых при вычислении размеров кучи и вызове CreatePlacedResource, используйте GetResourceAllocationInfo вместо GetResourceTiling. Для этого нельзя использовать GetResourceTiling.

Дополнительные сведения о ресурсах с плитками см. в разделе "Ресурсы с плитками томов".

Требования

См. также

ID3D12Device

Подресурсы