Metodo ID3D12Device::GetResourceTiling (d3d12.h)

Articolo
07/16/2024

Ottiene informazioni sul modo in cui una risorsa affiancata viene suddivisa in riquadri.

Sintassi

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

Parametri

[in] pTiledResource

Tipo: ID3D12Resource*

Specifica un affiancato ID3D12Resource per ottenere informazioni.

[out, optional] pNumTilesForEntireResource

Tipo: UINT*

Puntatore a una variabile che riceve il numero di riquadri necessari per archiviare l'intera risorsa affiancata.

[out, optional] pPackedMipDesc

Tipo: D3D12_PACKED_MIP_INFO*

Puntatore a una struttura di D3D12_PACKED_MIP_INFO che GetResourceTiling riempie di informazioni su come vengono compressi i mipmap della risorsa affiancata.

[out, optional] pStandardTileShapeForNonPackedMips

Tipo: D3D12_TILE_SHAPE*

Specifica una struttura D3D12_TILE_SHAPE che GetResourceTiling riempie con informazioni sulla forma del riquadro. Si tratta di informazioni sul modo in cui i pixel si adattano ai riquadri, indipendentemente dalle dimensioni della risorsa affiancata, senza includere mipmap compressi. Se l'intera risorsa affiancata è compressa, questo parametro è privo di significato perché la risorsa affiancata non ha alcun layout definito per mipmap compressi. In questo caso, GetResourceTiling imposta i membri di D3D12_TILE_SHAPE su zero.

[in, out, optional] pNumSubresourceTilings

Tipo: UINT*

Puntatore a una variabile che contiene il numero di riquadri nella sottorisorsa. In caso di input, si tratta del numero di sottorisorse per cui eseguire query sui tiling; nell'output, questo è il numero effettivamente recuperato in pSubresourceTilingsForNonPackedMips (bloccato a ciò che è disponibile).

[in] FirstSubresourceTilingToGet

Tipo: UINT

Numero del primo riquadro della sottorisorsa da ottenere. GetResourceTiling ignora questo parametro se il numero pNumSubresourceTilings punta a è 0.

[out] pSubresourceTilingsForNonPackedMips

Tipo: D3D12_SUBRESOURCE_TILING*

Specifica una struttura D3D12_SUBRESOURCE_TILING che GetResourceTiling riempie di informazioni sui riquadri della sottorisorsa. Se i riquadri di sottorisorsa fanno parte di mipmap compressi, GetResourceTiling imposta i membri di D3D12_SUBRESOURCE_TILING su zero, ad eccezione del membro StartTileInDexInOverallResourceResource, che GetResourceTiling imposta su D3D12_PACKED_TILE (0xffffffff). La costante D3D12_PACKED_TILE indica che l'intera struttura D3D12_SUBRESOURCE_TILING non ha significato per questa situazione e le informazioni da applicare al parametro pPackedMipDesc.

Valore restituito

Nessuno

Osservazioni

Per stimare le dimensioni totali delle risorse delle trame necessarie per calcolare le dimensioni dell'heap e chiamare CreatePlacedResource, usare GetResourceAllocationInfo anziché GetResourceTiling. non è possibile usare GetResourceTiling.

Per altre informazioni sulle risorse affiancate, vedere Risorse affiancate del volume.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Finestre
intestazione	d3d12.h
libreria	D3d12.lib
dll	D3d12.dll

Vedere anche

ID3D12Device

sottorisorse

Condividi tramite