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

Copia uma região de um recurso de origem para um recurso de destino.

Sintaxe

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*

Um ponteiro para o recurso de destino.

[in] DstSubresource

Tipo: UINT

Índice de sub-recurso de destino.

[in] DstX

Tipo: UINT

A coordenada x do canto superior esquerdo da região de destino.

[in] DstY

Tipo: UINT

A coordenada y do canto superior esquerdo da região de destino. Para um sub-recurso 1D, isso deve ser zero.

[in] DstZ

Tipo: UINT

A coordenada z do canto superior esquerdo da região de destino. Para um sub-recurso 1D ou 2D, isso deve ser zero.

[in] pSrcResource

Tipo: ID3D11Resource*

Um ponteiro para o recurso de origem.

[in] SrcSubresource

Tipo: UINT

Índice de sub-recurso de origem.

[in, optional] pSrcBox

Tipo: const D3D11_BOX*

Um ponteiro para uma caixa 3D que define a região do sub-recurso de origem que CopySubresourceRegion1 pode copiar. Se FOR NULL, CopySubresourceRegion1 copiará todo o sub-recurso de origem. A caixa deve caber dentro do recurso de origem.

Uma caixa vazia resulta em uma no-op. Uma caixa estará vazia se o valor superior for maior ou igual ao valor inferior ou se o valor esquerdo for maior ou igual ao valor à direita ou se o valor frontal for maior ou igual ao valor de fundo. Quando a caixa está vazia, CopySubresourceRegion1 não executa uma operação de cópia.

[in] CopyFlags

Tipo: UINT

Um valor de tipo D3D11_COPY_FLAGS que especifica como executar a operação de cópia. Se você especificar zero para nenhuma opção de cópia, CopySubresourceRegion1 se comportará como ID3D11DeviceContext::CopySubresourceRegion. Para drivers de exibição existentes que não podem processar esses sinalizadores, o runtime não os usa.

Valor retornado

Nenhum

Comentários

Se o driver de exibição der suporte à sobreposição, os sub-recursos de origem e destino poderão ser idênticos e as regiões de origem e destino poderão se sobrepor. Para drivers de exibição existentes que não dão suporte à sobreposição, o runtime descarta chamadas com sub-recursos de origem e destino idênticos, independentemente de as regiões se sobreporem. Para determinar se o driver de exibição dá suporte à sobreposição, marcar o membro CopyWithOverlap do D3D11_FEATURE_DATA_D3D11_OPTIONS. Esse suporte sobreposto permite funcionalidade de rolagem adicional em uma chamada para IDXGISwapChain::P resent.

ObservaçãoAplica-se somente ao nível do recurso 9_x hardware Se você usar ID3D11DeviceContext1::UpdateSubresource1 ou CopySubresourceRegion1 para copiar de um recurso de preparo para um recurso padrão, poderá corromper o conteúdo de destino. Isso ocorrerá se você passar uma caixa de origem NULL e se o recurso de origem tiver dimensões diferentes daquelas do recurso de destino ou se você usar deslocamentos de destino (x, y e z). Nessa situação, sempre passe uma caixa de origem que tenha o tamanho total do recurso de origem.

 

Requisitos

Cliente mínimo com suporte	Windows 8 e Platform Update para Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2012 e Platform Update para Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	d3d11_1.h
Biblioteca	D3D11.lib

Confira também

ID3D11DeviceContext1