Метод 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 нельзя использовать для этого.
Дополнительные сведения о ресурсах с плитками см. в ресурсов с плитками томов.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Виндоус |
| заголовка | d3d12.h |
| библиотеки |
D3d12.lib |
| DLL | D3d12.dll |