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 ausfü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 zum Kachel-Shape ausfü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 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 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-

Der Index der ersten zu erhaltenden Unterressource-Kachel. GetResourceTiling ignoriert diesen Parameter, wenn die Zahl, auf die pNumSubresourceTilings verweist, 0 ist.

[out] pSubresourceTilingsForNonPackedMips

Typ: D3D12_SUBRESOURCE_TILING*

Gibt eine D3D12_SUBRESOURCE_TILING Struktur an, die GetResourceTiling mit Informationen zu Unterressourcenkacheln ausfüllt. Wenn Unterressourcenkacheln Teil von verpackten Mipmaps sind, legt GetResourceTiling die Elemente 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, die der pPackedMipDesc-Parameter 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 beim Aufrufen von CreatePlacedResourceResourceInfo erforderlich sind. GetResourceTiling kann hierfür nicht verwendet werden.

Weitere Informationen zu unterteilten Ressourcen finden Sie unter "Volume Tiled Resources".

Anforderungen

Siehe auch

ID3D12Device-

Unterressourcen