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-source 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, il doit s’agir de 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, il doit s’agir de zéro.

[in] pSrcResource

Type : ID3D11Resource*

Pointeur vers la ressource source.

[in] SrcSubresource

Type : UINT

Index de sous-source source.

[in, optional] pSrcBox

Type : const D3D11_BOX*

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

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

[in] CopyFlags

Type : UINT

Valeur D3D11_COPY_FLAGS-typée 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

Aucun

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. Pour déterminer si le pilote d’affichage prend en charge le chevauchement, vérifiez le membre copyWithOverlap de D3D11_FEATURE_DATA_D3D11_OPTIONS. Cette prise en charge qui se chevauche permet d’ajouter des fonctionnalités de défilement supplémentaires 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 passez 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.

 

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 8 et Mise à jour de plateforme pour Windows 7 [applications de bureau | Applications UWP]
serveur minimum pris en charge	Windows Server 2012 et Mise à jour de plateforme pour Windows Server 2008 R2 [applications de bureau | Applications UWP]
plateforme cible	Windows
d’en-tête	d3d11_1.h
bibliothèque	D3D11.lib

Voir aussi

ID3D11DeviceContext1