ID3D11DeviceContext1::CopySubresourceRegion1, méthode (d3d11_1.h)

Copie une région d’une ressource source vers une ressource de destination.

Syntaxe

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

Paramètres

[in] pDstResource

Type : ID3D11Resource*

Pointeur vers la ressource de destination.

[in] DstSubresource

Type : UINT

Index de sous-ressource de destination.

[in] DstX

Type : UINT

Coordonnée x du coin supérieur gauche de la région de destination.

[in] DstY

Type : UINT

Coordonnée y du coin supérieur gauche de la région de destination. Pour une sous-ressource 1D, cette valeur doit être égale à zéro.

[in] DstZ

Type : UINT

Coordonnée z du coin supérieur gauche de la région de destination. Pour une sous-ressource 1D ou 2D, cette valeur doit être égale à zéro.

[in] pSrcResource

Type : ID3D11Resource*

Pointeur vers la ressource source.

[in] SrcSubresource

Type : UINT

Index de sous-ressource source.

[in, optional] pSrcBox

Type : const D3D11_BOX*

Pointeur vers une zone 3D qui définit la région de la sous-ressource source que CopySubresourceRegion1 peut copier. Si la valeur est NULL, CopySubresourceRegion1 copie la sous-ressource source entière. La zone doit s’adapter à la ressource source.

Une zone vide génère une opération de non-opération. Une zone est vide si la valeur supérieure est supérieure ou égale à la valeur inférieure, ou si la valeur de gauche est supérieure ou égale à la valeur de droite, ou si la valeur avant est supérieure ou égale à la valeur arrière. Lorsque la zone est vide, CopySubresourceRegion1 n’effectue pas d’opération de copie.

[in] CopyFlags

Type : UINT

Valeur de type D3D11_COPY_FLAGS qui spécifie comment effectuer l’opération de copie. Si vous spécifiez zéro pour aucune option de copie, CopySubresourceRegion1 se comporte comme ID3D11DeviceContext::CopySubresourceRegion. Pour les pilotes d’affichage existants qui ne peuvent pas traiter ces indicateurs, le runtime ne les utilise pas.

Valeur de retour

None

Remarques

Si le pilote d’affichage prend en charge le chevauchement, les sous-ressources source et de destination peuvent être identiques, et les régions source et de destination peuvent se chevaucher. Pour les pilotes d’affichage existants qui ne prennent pas en charge le chevauchement, le runtime supprime les appels avec des sous-ressources source et de destination identiques, que les régions se chevauchent ou non. Pour déterminer si le pilote d’affichage prend en charge le chevauchement, case activée le membre CopyWithOverlap de D3D11_FEATURE_DATA_D3D11_OPTIONS. Cette prise en charge du chevauchement permet d’ajouter des fonctionnalités de défilement dans un appel à IDXGISwapChain::P resent.

RemarqueS’applique uniquement au niveau des fonctionnalités 9_x matériel Si vous utilisez ID3D11DeviceContext1::UpdateSubresource1 ou CopySubresourceRegion1 pour copier à partir d’une ressource intermédiaire vers une ressource par défaut, vous pouvez endommager le contenu de destination. Cela se produit si vous transmettez une zone source NULL et si la ressource source a des dimensions différentes de celles de la ressource de destination ou si vous utilisez des décalages de destination (x, y et z). Dans ce cas, transmettez toujours une zone source qui correspond à la taille complète de la ressource source.

 

Configuration requise

Client minimal pris en charge	Windows 8 et Mise à jour de plateforme pour Windows 7 [applications de bureau | Applications UWP]
Serveur minimal pris en charge	Windows Server 2012 et mise à jour de plateforme pour Windows Server 2008 R2 [applications de bureau | Applications UWP]
Plateforme cible	Windows
En-tête	d3d11_1.h
Bibliothèque	D3D11.lib

Voir aussi

ID3D11DeviceContext1