Metodo ID3D12Device::GetResourceTiling (d3d12.h)

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

Vedere anche

ID3D12Device

sottorisorse