ID3D11DeviceContext1::CopySubresourceRegion1-Methode (d3d11_1.h)

Kopiert eine Region von einer Quellressource in eine Zielressource.

Syntax

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

Parameter

[in] pDstResource

Typ: ID3D11Resource*

Ein Zeiger auf die Zielressource.

[in] DstSubresource

Typ: UINT

Zielunterressourcenindex.

[in] DstX

Typ: UINT

Die x-Koordinate der oberen linken Ecke des Zielbereichs.

[in] DstY

Typ: UINT

Die y-Koordinate der oberen linken Ecke des Zielbereichs. Für eine 1D-Unterressource muss dies null sein.

[in] DstZ

Typ: UINT

Die Z-Koordinate der linken oberen Ecke des Zielbereichs. Für eine 1D- oder 2D-Unterressource muss dies 0 sein.

[in] pSrcResource

Typ: ID3D11Resource*

Ein Zeiger auf die Quellressource.

[in] SrcSubresource

Typ: UINT

Quellunterressourcenindex.

[in, optional] pSrcBox

Typ: const D3D11_BOX*

Ein Zeiger auf ein 3D-Feld, das die Region der Quellunterquelle definiert, die CopySubresourceRegion1 kopieren kann. Bei NULL kopiert CopySubresourceRegion1 die gesamte Quellunterquelle. Das Feld muss in die Quellressource passen.

Ein leeres Feld führt zu einer Nicht-Op. Ein Feld ist leer, wenn der oberste Wert größer oder gleich dem unteren Wert ist, oder wenn der linke Wert größer oder gleich dem rechten Wert ist, oder wenn der Frontwert größer als oder gleich dem back-Wert ist. Wenn das Feld leer ist, führt CopySubresourceRegion1 keinen Kopiervorgang aus.

[in] CopyFlags

Typ: UINT

Ein D3D11_COPY_FLAGS typisierter Wert, der angibt, wie der Kopiervorgang ausgeführt werden soll. Wenn Sie null für keine Kopieroption angeben, verhält sich CopySubresourceRegion1 wie ID3D11DeviceContext::CopySubresourceRegion. Für vorhandene Anzeigetreiber, die diese Flags nicht verarbeiten können, werden diese von der Runtime nicht verwendet.

Rückgabewert

Keine

Bemerkungen

Wenn der Anzeigetreiber Überschneidungen unterstützt, können die Quell- und Zielunterressourcen identisch sein, und die Quell- und Zielregionen können sich überlappen. Bei vorhandenen Anzeigetreibern, die keine Überlappung unterstützen, löscht die Runtime Aufrufe mit identischen Quell- und Zielunterressourcen, unabhängig davon, ob sich die Regionen überschneiden. Um zu ermitteln, ob der Anzeigetreiber Überschneidungen unterstützt, überprüfen Sie den CopyWithOverlap-Member von D3D11_FEATURE_DATA_D3D11_OPTIONS. Diese überlappende Unterstützung ermöglicht zusätzliche Scrollfunktionen in einem Aufruf von IDXGISwapChain::P resent.

HinweisGilt nur für Hardware auf Featureebene 9_x Wenn Sie ID3D11DeviceContext1::UpdateSubresource1 oder CopySubresourceRegion1 zum Kopieren von einer Stagingressource in eine Standardressource verwenden, können Sie den Zielinhalt beschädigen. Dies tritt auf, wenn Sie ein NULL-Quellfeld übergeben und die Quellressource andere Dimensionen als die der Zielressource aufweist oder wenn Sie Zieloffsets (x, y und z) verwenden. Übergeben Sie in dieser Situation immer ein Quellfeld, das die vollständige Größe der Quellressource aufweist.

 

Anforderungen

Unterstützte Mindestversion (Client)	Windows 8 und Plattformupdate für Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 und Plattformupdate für Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	d3d11_1.h
Bibliothek	D3D11.lib

Weitere Informationen

ID3D11DeviceContext1