Método ID3D12Device8::GetCopyableFootprints1 (d3d12.h)

  • Artículo

Obtiene un diseño de recursos que se puede copiar. Ayuda a la aplicación a rellenar D3D12_PLACED_SUBRESOURCE_FOOTPRINT y D3D12_SUBRESOURCE_FOOTPRINT cuando se coloca espacio en montones de carga.

Sintaxis

void GetCopyableFootprints1(
  const D3D12_RESOURCE_DESC1         *pResourceDesc,
  UINT                               FirstSubresource,
  UINT                               NumSubresources,
  UINT64                             BaseOffset,
  D3D12_PLACED_SUBRESOURCE_FOOTPRINT *pLayouts,
  UINT                               *pNumRows,
  UINT64                             *pRowSizeInBytes,
  UINT64                             *pTotalBytes
);

Parámetros

pResourceDesc

Tipo: const D3D12_RESOURCE_DESC1*

Descripción del recurso, como puntero a una estructura de D3D12_RESOURCE_DESC1 .

FirstSubresource

Tipo: [in] UINT

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

NumSubresources

Tipo: [in] UINT

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

BaseOffset

Tipo: UINT64

Desplazamiento, en bytes, al recurso.

pLayouts

Tipo: [out, opcional] D3D12_PLACED_SUBRESOURCE_FOOTPRINT*

Puntero a una matriz (de longitud NumSubresources) de D3D12_PLACED_SUBRESOURCE_FOOTPRINT estructuras, que se rellenarán con la descripción y colocación de cada subrecurso.

pNumRows

Tipo: [out, opcional] UINT*

Puntero a una matriz (de longitud NumSubresources) de variables de enteros, que se rellenarán con el número de filas de cada subrecurso.

pRowSizeInBytes

Tipo: [out, opcional] UINT64*

Puntero a una matriz (de longitud NumSubresources) de variables enteras, cada entrada que se va a rellenar con el tamaño sin rellenar en bytes de una fila, de cada subrecurso.

Por ejemplo, si un recurso Texture2D tiene un ancho de 32 bytes por píxel de 4, pRowSizeInBytes devuelve 128.

pRowSizeInBytes no debe confundirse con el tono de fila, ya que examinar pLayouts y obtener el tono de fila de que le dará 256 a medida que está alineado con D3D12_TEXTURE_DATA_PITCH_ALIGNMENT.

pTotalBytes

Tipo: [out, opcional] UINT64*

Puntero a una variable de entero, que se va a rellenar con el tamaño total, en bytes.

Valor devuelto

None

Observaciones

Para obtener comentarios y ejemplos, vea ID3D12Device::GetCopyableFootprints.

Requisitos

Requisito Value
Cliente mínimo compatible compilación 20348 de Windows 10
Servidor mínimo compatible compilación 20348 de Windows 10
Encabezado d3d12.h
Library d3d12.lib
Archivo DLL d3d12.dll

Consulte también