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.

Configuration requise

Voir aussi

ID3D11DeviceContext1