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.

Requisitos

Confira também

ID3D11DeviceContext1