Método ID3D11DeviceContext1::CopySubresourceRegion1 (d3d11_1.h)

Copia una región de un recurso de origen en un recurso de destino.

Sintaxis

void CopySubresourceRegion1(
  [in]           ID3D11Resource  *pDstResource,
  [in]           UINT            DstSubresource,
  [in]           UINT            DstX,
  [in]           UINT            DstY,
  [in]           UINT            DstZ,
  [in]           ID3D11Resource  *pSrcResource,
  [in]           UINT            SrcSubresource,
  [in, optional] const D3D11_BOX *pSrcBox,
  [in]           UINT            CopyFlags
);

Parámetros

[in] pDstResource

Tipo: ID3D11Resource*

Puntero al recurso de destino.

[in] DstSubresource

Tipo: UINT

Índice de subrecurso de destino.

[in] DstX

Tipo: UINT

Coordenada x de la esquina superior izquierda de la región de destino.

[in] DstY

Tipo: UINT

Coordenada y de la esquina superior izquierda de la región de destino. Para un subrecurso 1D, debe ser cero.

[in] DstZ

Tipo: UINT

Coordenada z de la esquina superior izquierda de la región de destino. Para un subrecurso 1D o 2D, debe ser cero.

[in] pSrcResource

Tipo: ID3D11Resource*

Puntero al recurso de origen.

[in] SrcSubresource

Tipo: UINT

Índice de subrecurso de origen.

[in, optional] pSrcBox

Tipo: const D3D11_BOX*

Puntero a un cuadro 3D que define la región del subrecurso de origen que CopySubresourceRegion1 puede copiar. Si es NULL, CopySubresourceRegion1 copia todo el subrecurso de origen. El cuadro debe caber dentro del recurso de origen.

Un cuadro vacío da como resultado una operación sin operación. Un cuadro está vacío si el valor superior es mayor o igual que el valor inferior, o el valor izquierdo es mayor o igual que el valor derecho, o el valor frontal es mayor o igual que el valor atrás. Cuando el cuadro está vacío, CopySubresourceRegion1 no realiza una operación de copia.

[in] CopyFlags

Tipo: UINT

Valor con tipo D3D11_COPY_FLAGS que especifica cómo realizar la operación de copia. Si especifica cero para ninguna opción de copia, CopySubresourceRegion1 se comporta como ID3D11DeviceContext::CopySubresourceRegion. En el caso de los controladores de pantalla existentes que no pueden procesar estas marcas, el entorno de ejecución no los usa.

Valor devuelto

None

Observaciones

Si el controlador de pantalla admite la superposición, los subrecursos de origen y destino pueden ser idénticos y las regiones de origen y destino se pueden superponer entre sí. En el caso de los controladores de pantalla existentes que no admiten la superposición, el tiempo de ejecución quita las llamadas con subrecursos de origen y destino idénticos, independientemente de si las regiones se superponen. Para determinar si el controlador de pantalla admite la superposición, compruebe el miembro CopyWithOverlap de D3D11_FEATURE_DATA_D3D11_OPTIONS. Esta compatibilidad superpuesta permite una funcionalidad de desplazamiento adicional en una llamada a IDXGISwapChain::P resent.

NotaSolo se aplica al nivel de característica 9_x hardware Si usa ID3D11DeviceContext1::UpdateSubresource1 o CopySubresourceRegion1 para copiar desde un recurso provisional a un recurso predeterminado, puede dañar el contenido de destino. Esto ocurre si pasa un cuadro de origen NULL y si el recurso de origen tiene dimensiones diferentes de las del recurso de destino o si usa desplazamientos de destino (x, y y z). En esta situación, pase siempre un cuadro de origen que sea el tamaño completo del recurso de origen.

 

Requisitos

Cliente mínimo compatible	Actualización de windows 8 y plataforma para Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2012 y Actualización de plataforma para Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	d3d11_1.h
Library	D3D11.lib

Consulte también

ID3D11DeviceContext1