ID3D12Device::GetResourceTiling-Methode (d3d12.h)
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
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für