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

Статья
08/23/2023

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

Синтаксис

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 заполняет сведениями о том, как упаковываются MIP-карты мозаичного ресурса.

[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 заполняет сведениями о плитках подресурсов. Если плитки подресурсов являются частью упакованных MIP-карт, GetResourceTiling задает для членов D3D12_SUBRESOURCE_TILING нули, за исключением элемента StartTileIndexInOverallResourceResource, для которого GetResourceTiling задает D3D12_PACKED_TILE (0xffffffff). Константой D3D12_PACKED_TILE указывает, что вся структура D3D12_SUBRESOURCE_TILING бессмысленна для этой ситуации, а также сведения, на которые указывает параметр pPackedMipDesc .

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

None

Remarks

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

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

Требования


Целевая платформа	Windows
Header	d3d12.h
Библиотека	D3d12.lib
DLL	D3d12.dll

См. также раздел

ID3D12Device

Подресурсы

Share via