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

Copia las asignaciones de un recurso en mosaico de origen en un recurso en mosaico de destino.

Sintaxis

HRESULT CopyTileMappings(
  [in] ID3D11Resource                        *pDestTiledResource,
  [in] const D3D11_TILED_RESOURCE_COORDINATE *pDestRegionStartCoordinate,
  [in] ID3D11Resource                        *pSourceTiledResource,
  [in] const D3D11_TILED_RESOURCE_COORDINATE *pSourceRegionStartCoordinate,
  [in] const D3D11_TILE_REGION_SIZE          *pTileRegionSize,
  [in] UINT                                  Flags
);

Parámetros

[in] pDestTiledResource

Tipo: ID3D11Resource*

Puntero al recurso en mosaico de destino.

[in] pDestRegionStartCoordinate

Tipo: const D3D11_TILED_RESOURCE_COORDINATE*

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

[in] pSourceTiledResource

Tipo: ID3D11Resource*

Puntero al recurso en mosaico de origen.

[in] pSourceRegionStartCoordinate

Tipo: const D3D11_TILED_RESOURCE_COORDINATE*

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

[in] pTileRegionSize

Tipo: const D3D11_TILE_REGION_SIZE*

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

[in] Flags

Tipo: UINT

Combinación de D3D11_TILE_MAPPING_FLAGS valores que se combinan mediante una operación OR bit a bit. El único valor válido es D3D11_TILE_MAPPING_NO_OVERWRITE, lo que indica que los comandos enviados previamente al dispositivo que todavía se están ejecutando no hacen referencia a ninguna de las regiones de icono que se están actualizando. Después, el dispositivo puede evitar tener que vaciar el trabajo enviado previamente para realizar la actualización de asignación de iconos. Si la aplicación infringe esta promesa mediante la actualización de asignaciones de iconos para ubicaciones en recursos en mosaico a las que todavía se hace referencia mediante comandos pendientes, resultados de comportamiento de representación no definidos, incluida la posibilidad de ralentizaciones significativas en algunas arquitecturas. Esto es como el concepto de "no sobrescribir" que existe en otra parte de la API de Direct3D, excepto que se aplica a la propia estructura de datos de asignación de iconos (que en hardware es una tabla de páginas). La ausencia del valor de D3D11_TILE_MAPPING_NO_OVERWRITE requiere que se completen las actualizaciones de asignación de iconos que especifica CopyTileMappings antes de que pueda continuar cualquier comando direct3D posterior.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se ejecuta correctamente; de lo contrario, devuelve una de las siguientes opciones:

• Devuelve E_INVALIDARG si varias condiciones, como marcas no válidas o pasar recursos no en mosaico, dan como resultado la eliminación de la llamada. El valor dest y las regiones de origen deben ajustarse completamente a su recurso o comportamiento no está definido (la capa de depuración emitirá un error).
• Devuelve E_OUTOFMEMORY si la llamada da como resultado que el controlador tenga que asignar espacio para las nuevas asignaciones de tabla de páginas, pero que se agote la memoria. Si se produce una falta de memoria cuando se llama a en una lista de comandos y se ejecuta la lista de comandos, se quitará el dispositivo. Las aplicaciones solo pueden evitar esta situación realizando llamadas de actualización que cambian las asignaciones existentes de recursos en mosaico dentro de listas de comandos (por lo que los controladores no tendrán que asignar memoria de tabla de páginas, solo cambiar la asignación).

Comentarios

CopyTileMappings ayuda con tareas como el cambio de asignaciones entre los recursos en mosaico, por ejemplo, el desplazamiento de iconos. Las regiones de origen y destino se pueden superponer; El resultado de la copia en esta situación es como si el origen se guardara en una ubicación temporal y, a continuación, desde allí escrito en el destino.

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

Requisitos

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