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

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

Никакой

Замечания

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

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

Требования

См. также

ID3D12Device

субресурсов