Función UpdateSubresources

Artículo
06/13/2023

Novedades subrecursos, todas las matrices de subrecursos deben rellenarse, normalmente llamando a ID3D12Device::GetCopyableFootprints.

Sintaxis

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*

Lista de comandos, como puntero a un id3D12GraphicsCommandList.

pDestinationResource [in]

Tipo: ID3D12Resource*

El recurso de destino, como puntero a un id3D12Resource.

pIntermediate [in]

Tipo: ID3D12Resource*

El recurso intermedio, como puntero a un id3D12Resource.

FirstSubresource [in]

Tipo: UINT

Índice del primer subrecurso del recurso. El intervalo de valores válidos es de 0 a D3D12_REQ_SUBRESOURCES.

NumSubresources [in]

Tipo: UINT

Número de subrecursos del recurso. El intervalo de valores válidos es de 0 a (D3D12_REQ_SUBRESOURCES - FirstSubresource).

RequiredSize

Tipo: UINT64

Tamaño necesario, en bytes, para la actualización.

pLayouts [in]

Tipo: const D3D12_PLACED_SUBRESOURCE_FOOTPRINT*

Puntero a una matriz (de longitud NumSubresources) de punteros a las estructuras que contienen la descripción y la ubicación de los subrecursos del recurso.

pNumRows [in]

Tipo: const UINT*

Puntero a una matriz (de longitud NumSubresources) de UINTS que contiene el número de filas para cada subrecurso.

pRowSizesInBytes [in]

Tipo: const UINT64*

Puntero a una matriz (de longitud NumSubresources) de UINTS que contiene el tamaño, en bytes, de cada fila.

pSrcData [in]

Tipo: const D3D12_SUBRESOURCE_DATA*

Puntero a una matriz (de longitud NumSubresources) de punteros a D3D12_SUBRESOURCE_DATA estructuras que contienen descripciones de los datos subrecursos usados para la actualización.

Valor devuelto

Tipo: UINT64

Tamaño del búfer en bytes.

Requisitos

Requisito	Value
Encabezado	D3dx12.h
Biblioteca	D3D12.lib
Archivo DLL	D3D12.dll

Consulte también

Funciones auxiliares de D3D12
Subrecursos