Função UpdateSubresources

Artigo
06/13/2023

Atualizações sub-recursos, todas as matrizes de sub-recursos devem ser preenchidas, normalmente chamando ID3D12Device::GetCopyableFootprints.

Sintaxe

UINT64 inline UpdateSubresources(
  _In_       ID3D12GraphicsCommandList          *pCmdList,
  _In_       ID3D12Resource                     *pDestinationResource,
  _In_       ID3D12Resource                     *pIntermediate,
  _In_       UINT                               FirstSubresource,
  _In_       UINT                               NumSubresources,
             UINT64                             RequiredSize,
  _In_ const D3D12_PLACED_SUBRESOURCE_FOOTPRINT *pLayouts,
  _In_ const UINT                               *pNumRows,
  _In_ const UINT64                             *pRowSizesInBytes,
  _In_ const D3D12_SUBRESOURCE_DATA             *pSrcData
);

Parâmetros

pCmdList [in]

Tipo: ID3D12GraphicsCommandList*

A lista de comandos, como um ponteiro para um ID3D12GraphicsCommandList.

pDestinationResource [in]

Tipo: ID3D12Resource*

O recurso de destino, como um ponteiro para um ID3D12Resource.

pIntermediate [in]

Tipo: ID3D12Resource*

O recurso intermediário, como um ponteiro para um ID3D12Resource.

FirstSubresource [in]

Tipo: UINT

O índice da primeira sub-fonte no recurso. O intervalo de valores válidos é de 0 a D3D12_REQ_SUBRESOURCES.

NumSubresources [in]

Tipo: UINT

O número de sub-recursos no recurso. O intervalo de valores válidos é de 0 a (D3D12_REQ_SUBRESOURCES – FirstSubresource).

RequiredSize

Tipo: UINT64

O tamanho necessário, em bytes, para a atualização.

pLayouts [in]

Tipo: const D3D12_PLACED_SUBRESOURCE_FOOTPRINT*

Ponteiro para uma matriz (de tamanho NumSubresources) de ponteiros para as estruturas que contêm a descrição e o posicionamento dos sub-recursos do recurso.

pNumRows [in]

Tipo: const UINT*

Ponteiro para uma matriz (de tamanho NumSubresources) de UINTS que contém o número de linhas para cada sub-recurso.

pRowSizesInBytes [in]

Tipo: const UINT64*

Ponteiro para uma matriz (de tamanho NumSubresources) de UINTS que contém o tamanho, em bytes, de cada linha.

pSrcData [in]

Tipo: const D3D12_SUBRESOURCE_DATA*

Ponteiro para uma matriz (de tamanho NumSubresources) de ponteiros para D3D12_SUBRESOURCE_DATA estruturas que contêm descrições dos dados de sub-recursos usados para a atualização.

Valor retornado

Tipo: UINT64

O tamanho do buffer, em bytes.

Requisitos

Requisito	Valor
parâmetro	D3dx12.h
Biblioteca	D3D12.lib
DLL	D3D12.dll

Confira também

Funções auxiliares do D3D12
Sub-recursos

Compartilhar via