Share via

ID3D12Device::GetResourceTiling-Methode (d3d12.h)

  • Artikel

Ruft Informationen dazu ab, wie eine kachelnte Ressource in Kacheln unterteilt wird.

Syntax

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
);

Parameter

[in] pTiledResource

Typ: ID3D12Resource*

Gibt eine kachelierte ID3D12Resource an, über die Informationen abgerufen werden sollen.

[out, optional] pNumTilesForEntireResource

Typ: UINT*

Ein Zeiger auf eine Variable, die die Anzahl der Kacheln empfängt, die zum Speichern der gesamten kachelten Ressource erforderlich sind.

[out, optional] pPackedMipDesc

Typ: D3D12_PACKED_MIP_INFO*

Ein Zeiger auf eine D3D12_PACKED_MIP_INFO Struktur, die GetResourceTiling mit Informationen darüber füllt, wie die Mipmaps der kachelnden Ressource gepackt werden.

[out, optional] pStandardTileShapeForNonPackedMips

Typ: D3D12_TILE_SHAPE*

Gibt eine D3D12_TILE_SHAPE Struktur an, die GetResourceTiling mit Informationen zur Kachelform auffüllt. Dies sind Informationen darüber, wie Pixel in die Kacheln passen, unabhängig von den Abmessungen der gekachelten Ressource, ohne gepackte Mipmaps. Wenn die gesamte kachelierte Ressource gepackt ist, ist dieser Parameter bedeutungslos, da die kachelte Ressource kein definiertes Layout für gepackte Mipmaps aufweist. In diesem Fall legt GetResourceTiling die Member von D3D12_TILE_SHAPE auf Nullen fest.

[in, out, optional] pNumSubresourceTilings

Typ: UINT*

Ein Zeiger auf eine Variable, die die Anzahl der Kacheln in der Unterressource enthält. Bei der Eingabe ist dies die Anzahl der Unterressourcen, für die Abfragekacheln verwendet werden sollen. bei der Ausgabe ist dies die Zahl, die tatsächlich bei pSubresourceTilingsForNonPackedMips abgerufen wurde (geklammert auf das, was verfügbar ist).

[in] FirstSubresourceTilingToGet

Typ: UINT

Die Nummer der ersten abzurufenden Unterressourcenkachel. GetResourceTiling ignoriert diesen Parameter, wenn die Zahl, auf die pNumSubresourceTilings zeigt, 0 ist.

[out] pSubresourceTilingsForNonPackedMips

Typ: D3D12_SUBRESOURCE_TILING*

Gibt eine D3D12_SUBRESOURCE_TILING-Struktur an, die GetResourceTiling mit Informationen zu Untergeordneten Ressourcenkacheln auffüllt. Wenn Unterressourcenkacheln Teil von gepackten Mipmaps sind, legt GetResourceTiling die Member von D3D12_SUBRESOURCE_TILING auf Nullen fest, mit Ausnahme des StartTileIndexInOverallResource-Elements , das GetResourceTiling auf D3D12_PACKED_TILE (0xffffffff) festlegt. Die D3D12_PACKED_TILE-Konstante gibt an, dass die gesamte D3D12_SUBRESOURCE_TILING-Struktur für diese Situation bedeutungslos ist, und die Informationen, auf die der pPackedMipDesc-Parameter verweist, gelten.

Rückgabewert

Keine

Bemerkungen

Verwenden Sie getResourceAllocationInfo anstelle von GetResourceTiling, um die Gesamtressourcengröße der Texturen zu schätzen, die beim Berechnen der Heapgrößen und beim Aufrufen von CreatePlacedResourceResource erforderlich sind. GetResourceTiling kann dafür nicht verwendet werden.

Weitere Informationen zu kachelnden Ressourcen finden Sie unter VolumeKachelierte Ressourcen.

Anforderungen

   
Zielplattform Windows
Kopfzeile d3d12.h
Bibliothek D3d12.lib
DLL D3d12.dll

Weitere Informationen

ID3D12Device

Unterressourcen