Método ID3D11DeviceContext2::CopyTiles (d3d11_2.h)

  • Artículo

Copia iconos del búfer en un recurso en mosaico o viceversa.

Sintaxis

void CopyTiles(
  [in] ID3D11Resource                        *pTiledResource,
  [in] const D3D11_TILED_RESOURCE_COORDINATE *pTileRegionStartCoordinate,
  [in] const D3D11_TILE_REGION_SIZE          *pTileRegionSize,
  [in] ID3D11Buffer                          *pBuffer,
  [in] UINT64                                BufferStartOffsetInBytes,
  [in] UINT                                  Flags
);

Parámetros

[in] pTiledResource

Tipo: ID3D11Resource*

Puntero a un recurso en mosaico.

[in] pTileRegionStartCoordinate

Tipo: const D3D11_TILED_RESOURCE_COORDINATE*

Puntero a una estructura de D3D11_TILED_RESOURCE_COORDINATE que describe las coordenadas iniciales del recurso en mosaico.

[in] pTileRegionSize

Tipo: const D3D11_TILE_REGION_SIZE*

Puntero a una estructura de D3D11_TILE_REGION_SIZE que describe el tamaño de la región en mosaico.

[in] pBuffer

Tipo: ID3D11Buffer*

Puntero a un búfer ID3D11Buffer que representa un búfer predeterminado, dinámico o provisional.

[in] BufferStartOffsetInBytes

Tipo: UINT64

Desplazamiento en bytes en el búfer en pBuffer para iniciar la operación.

[in] Flags

Tipo: UINT

Combinación de valores con tipo D3D11_TILE_COPY_FLAG que se combinan mediante una operación OR bit a bit e identifica cómo copiar iconos.

Valor devuelto

None

Observaciones

CopyTiles quita las operaciones de escritura en áreas no asignadas y controla las operaciones de lectura de áreas no asignadas (excepto en Tier_1 recursos en mosaico, donde la lectura y escritura de áreas no asignadas no son válidas).

Si una operación de copia implica escribir en la misma ubicación de memoria varias veces porque varias ubicaciones del recurso de destino se asignan a la misma memoria de mosaico, las operaciones de escritura resultantes en mosaicos multiasignados son no deterministas y no repetibles; es decir, los accesos a la memoria del icono se producen en cualquier orden en que el hardware se ejecute la operación de copia.

Los iconos implicados en la operación de copia no pueden incluir iconos que contengan mapas mip empaquetados o los resultados de la operación de copia no están definidos. Para transferir datos hacia y desde mapas mip que el hardware empaqueta en los iconos uno o más que constituyen los mips empaquetados, Debe usar las API de copia y actualización estándar (es decir, no específicas del icono) (como ID3D11DeviceContext1::CopySubresourceRegion1 e ID3D11DeviceContext1::UpdateSubresource1) o ID3D11DeviceContext::GenerateMips para toda la cadena mipmap.

El diseño de memoria de los iconos del lado del recurso de búfer no en mosaico de la operación de copia es lineal en memoria en mosaicos de 64 KB, que el hardware y el controlador giran y deswizzle por icono según corresponda cuando se transfieren a y desde un recurso en mosaico. Para las superficies de suavizado multimuestra (MSAA), el hardware y el controlador atraviesan las muestras de cada píxel en orden de índice de muestra antes de pasar al siguiente píxel. En el caso de los iconos que se rellenan parcialmente en el lado derecho (para una superficie que tiene un ancho no múltiplo de ancho de mosaico en píxeles), el tono y el paso para bajar una fila es el tamaño completo en bytes del número de píxeles que caben en el icono si el icono estaba lleno. Por lo tanto, puede haber un espacio entre cada fila de píxeles en memoria. Los mapas Mip que son más pequeños que un icono no se empaquetan juntos en el diseño lineal, lo que podría parecer un desperdicio de espacio de memoria, pero como se mencionó, no puede usar CopyTiles o ID3D11DeviceContext2::UpdateTiles para copiar en mapas mip que el hardware empaqueta juntos. Solo puede usar API genéricas de copia y actualización (como ID3D11DeviceContext1::CopySubresourceRegion1 e ID3D11DeviceContext1::UpdateSubresource1) para copiar mapas mip pequeños individualmente. Aunque en el caso de una API de copia genérica (como ID3D11DeviceContext1::CopySubresourceRegion1), la memoria lineal debe ser la misma dimensión que el recurso en mosaico; ID3D11DeviceContext1::CopySubresourceRegion1 no se puede copiar desde un recurso de búfer a texture2D por ejemplo.

Para obtener más información sobre los recursos en mosaico, consulte Recursos en mosaico.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8.1 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2012 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado d3d11_2.h
Library D3D11.lib

Consulte también

ID3D11DeviceContext2