ID3D12Device::GetResourceTiling-Methode (d3d12.h)

Ruft Informationen dazu ab, wie eine nebeneinander angeordnete 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 nebeneinander angeordnete 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 nebeneinander angeordneten 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 gefüllt, wie die Mipmaps der unterteilten Ressource gepackt werden.

[out, optional] pStandardTileShapeForNonPackedMips

Typ: D3D12_TILE_SHAPE*

Gibt eine D3D12_TILE_SHAPE Struktur an, die GetResourceTiling mit Informationen zur Kachelform gefüllt. Dies ist Informationen dazu, wie Pixel in die Kacheln passen, unabhängig von den Dimensionen der nebeneinander angeordneten Ressource, nicht einschließlich verpackter Mipmaps. Wenn die gesamte nebeneinander angeordnete Ressource verpackt ist, ist dieser Parameter bedeutungslos, da die nebeneinander angeordnete Ressource kein definiertes Layout für verpackte Mipmaps aufweist. In diesem Fall legt GetResourceTiling die Elemente 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 eingaben ist dies die Anzahl der Unterressourcen, für die Tilings angefordert werden sollen; bei der Ausgabe ist dies die Zahl, die tatsächlich bei pSubresourceTilingsForNonPackedMips abgerufen wurde (an die verfügbaren Elemente geklammert).

[in] FirstSubresourceTilingToGet

Typ: UINT-

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

[out] pSubresourceTilingsForNonPackedMips

Typ: D3D12_SUBRESOURCE_TILING*

Gibt eine D3D12_SUBRESOURCE_TILING Struktur an, die GetResourceTiling mit Informationen zu Unterressourcenkacheln gefüllt. Wenn Unterressourcenkacheln Teil von verpackten Mipmaps sind, legt GetResourceTiling die Elemente von D3D12_SUBRESOURCE_TILING auf Nullen fest, mit Ausnahme der StartTileIndexInOverallResource Member, 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, auf den zutrifft.

Rückgabewert

Nichts

Bemerkungen

Verwenden Sie GetResourceAllocationInfo- anstelle von GetResourceTiling, um die Gesamtressourcengröße von Texturen zu schätzen, die beim Berechnen von Heapgrößen und aufrufen CreatePlacedResourceResourceerforderlich sind. GetResourceTiling- kann hierfür nicht verwendet werden.

Weitere Informationen zu nebeneinander angeordneten Ressourcen finden Sie unter Volume Tiled Resources.

Anforderungen

Siehe auch

ID3D12Device-

Unterressourcen