ID3D11Device2::GetResourceTiling-Methode (d3d11_2.h)

Artikel
08/22/2023

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

Syntax

void GetResourceTiling(
  [in]                ID3D11Resource           *pTiledResource,
  [out, optional]     UINT                     *pNumTilesForEntireResource,
  [out, optional]     D3D11_PACKED_MIP_DESC    *pPackedMipDesc,
  [out, optional]     D3D11_TILE_SHAPE         *pStandardTileShapeForNonPackedMips,
  [in, out, optional] UINT                     *pNumSubresourceTilings,
  [in]                UINT                     FirstSubresourceTilingToGet,
  [out]               D3D11_SUBRESOURCE_TILING *pSubresourceTilingsForNonPackedMips
);

Parameter

[in] pTiledResource

Typ: ID3D11Resource*

Ein Zeiger auf die kachelte Ressource, zu der 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: D3D11_PACKED_MIP_DESC*

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

[out, optional] pStandardTileShapeForNonPackedMips

Typ: D3D11_TILE_SHAPE*

Ein Zeiger auf eine D3D11_TILE_SHAPE Struktur, 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 D3D11_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: D3D11_SUBRESOURCE_TILING*

Ein Zeiger auf eine D3D11_SUBRESOURCE_TILING Struktur, die GetResourceTiling mit Informationen zu Untergeordneten Ressourcenkacheln auffüllt.

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

Rückgabewert

Keine

Bemerkungen

Weitere Informationen zu kachelnden Ressourcen finden Sie unter Gekachelte Ressourcen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 8.1 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 R2 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	d3d11_2.h
Bibliothek	D3D11.lib

Weitere Informationen

ID3D11Geräte2

Freigeben über