Condividi tramite

Metodo ID3D11DeviceContext1::CopySubresourceRegion1 (d3d11_1.h)

  • Articolo

Copia un'area da una risorsa di origine a una risorsa di destinazione.

Sintassi

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
);

Parametri

[in] pDstResource

Tipo: ID3D11Resource*

Puntatore alla risorsa di destinazione.

[in] DstSubresource

Tipo: UINT

Indice della sottorisorsa di destinazione.

[in] DstX

Tipo: UINT

Coordinata x dell'angolo superiore sinistro dell'area di destinazione.

[in] DstY

Tipo: UINT

Coordinata y dell'angolo superiore sinistro dell'area di destinazione. Per una sottorisorsa 1D, questo deve essere zero.

[in] DstZ

Tipo: UINT

Coordinata z dell'angolo superiore sinistro dell'area di destinazione. Per una sottorisorsa 1D o 2D, questo deve essere zero.

[in] pSrcResource

Tipo: ID3D11Resource*

Puntatore alla risorsa di origine.

[in] SrcSubresource

Tipo: UINT

Indice della sottorisorsa di origine.

[in, optional] pSrcBox

Tipo: const D3D11_BOX*

Puntatore a una casella 3D che definisce l'area della sottorisorsa di origine che CopySubresourceRegion1 può copiare. Se NULL, CopySubresourceRegion1 copia l'intera sottorisorsa di origine. La casella deve rientrare nella risorsa di origine.

Una casella vuota restituisce un no-op. Una casella è vuota se il valore superiore è maggiore o uguale al valore inferiore oppure il valore sinistro è maggiore o uguale al valore destro oppure il valore anteriore è maggiore o uguale al valore indietro. Quando la casella è vuota, CopySubresourceRegion1 non esegue un'operazione di copia.

[in] CopyFlags

Tipo: UINT

Valore tipizzato D3D11_COPY_FLAGS che specifica come eseguire l'operazione di copia. Se si specifica zero per nessuna opzione di copia, CopySubresourceRegion1 si comporta come ID3D11DeviceContext::CopySubresourceRegion. Per i driver di visualizzazione esistenti che non possono elaborare questi flag, il runtime non li usa.

Valore restituito

nessuno

Osservazioni

Se il driver di visualizzazione supporta la sovrapposizione, le sottorisorse di origine e di destinazione possono essere identiche e le aree di origine e di destinazione possono sovrapporsi tra loro. Per i driver di visualizzazione esistenti che non supportano la sovrapposizione, il runtime elimina le chiamate con sottorisorse di origine e di destinazione identiche, indipendentemente dal fatto che le aree si sovrappongano. Per determinare se il driver di visualizzazione supporta la sovrapposizione, controllare il membro CopyWithOverlap di D3D11_FEATURE_DATA_D3D11_OPTIONS. Questo supporto sovrapposto consente funzionalità di scorrimento aggiuntive in una chiamata a IDXGISwapChain::P resent.

NotaSi applica solo al livello di funzionalità 9_x hardware Se si usa ID3D11DeviceContext1::UpdateSubresource1 o CopySubresourceRegion1 per copiare da una risorsa di staging a una risorsa predefinita, è possibile danneggiare il contenuto di destinazione. Ciò si verifica se si passa una casella di origine NULL e se la risorsa di origine ha dimensioni diverse da quelle della risorsa di destinazione o se si usano offset di destinazione, (x, y e z). In questo caso, passare sempre una casella di origine che corrisponde alle dimensioni complete della risorsa di origine.
 

Requisiti

   
Client minimo supportato Windows 8 e Platform Update per Windows 7 [app desktop | App UWP]
Server minimo supportato Windows Server 2012 e Aggiornamento della piattaforma per Windows Server 2008 R2 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione d3d11_1.h
Libreria D3D11.lib

Vedi anche

ID3D11DeviceContext1