Share via

METODE ID3D11DeviceContext1::CopySubresourceRegion1 (d3d11_1.h)

  • Artikel

Menyalin wilayah dari sumber daya sumber ke sumber daya tujuan.

Sintaks

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

Jenis: ID3D11Resource*

Penunjuk ke sumber daya tujuan.

[in] DstSubresource

Jenis: UINT

Indeks subsumber daya tujuan.

[in] DstX

Jenis: UINT

Koordinat x sudut kiri atas wilayah tujuan.

[in] DstY

Jenis: UINT

Koordinat y dari sudut kiri atas wilayah tujuan. Untuk subsumber daya 1D, ini harus nol.

[in] DstZ

Jenis: UINT

Koordinat z dari sudut kiri atas wilayah tujuan. Untuk sub sumber daya 1D atau 2D, ini harus nol.

[in] pSrcResource

Jenis: ID3D11Resource*

Penunjuk ke sumber daya sumber.

[in] SrcSubresource

Jenis: UINT

Indeks subsumber daya sumber.

[in, optional] pSrcBox

Jenis: const D3D11_BOX*

Penunjuk ke kotak 3D yang menentukan wilayah sub-sumber sumber yang dapat disalin copySubresourceRegion1 . Jika NULL, CopySubresourceRegion1 menyalin seluruh subsumber daya. Kotak harus pas dalam sumber daya sumber.

Kotak kosong menghasilkan no-op. Kotak kosong jika nilai atas lebih besar dari atau sama dengan nilai bawah, atau nilai kiri lebih besar dari atau sama dengan nilai kanan, atau nilai depan lebih besar dari atau sama dengan nilai belakang. Saat kotak kosong, CopySubresourceRegion1 tidak melakukan operasi salin.

[in] CopyFlags

Jenis: UINT

Nilai D3D11_COPY_FLAGS-typed yang menentukan cara melakukan operasi salin. Jika Anda menentukan nol tanpa opsi salin, CopySubresourceRegion1 bertingkah seperti ID3D11DeviceContext::CopySubresourceRegion. Untuk driver tampilan yang ada yang tidak dapat memproses bendera ini, runtime tidak menggunakannya.

Mengembalikan nilai

Tidak ada

Keterangan

Jika driver tampilan mendukung tumpang tindih, subsumber daya sumber dan tujuan dapat identik, dan wilayah sumber dan tujuan dapat saling tumpang tindih. Untuk driver tampilan yang ada yang tidak mendukung tumpang tindih, runtime menjatuhkan panggilan dengan sumber dan subsumber daya tujuan yang identik, terlepas dari apakah wilayah tumpang tindih. Untuk menentukan apakah driver tampilan mendukung tumpang tindih, periksa anggota copyWithOverlapD3D11_FEATURE_DATA_D3D11_OPTIONS. Dukungan yang tumpang tindih ini memungkinkan fungsi gulir tambahan dalam panggilan ke IDXGISwapChain::P resent.

CatatanHanya berlaku untuk tingkat fitur 9_x perangkat keras Jika Anda menggunakan ID3D11DeviceContext1::UpdateSubresource1 atau CopySubresourceRegion1 untuk menyalin dari sumber daya penahapan ke sumber daya default, Anda dapat merusak konten tujuan. Ini terjadi jika Anda melewati kotak sumber NULL dan jika sumber daya sumber memiliki dimensi yang berbeda dari sumber daya tujuan atau jika Anda menggunakan offset tujuan, (x, y, dan z). Dalam situasi ini, selalu berikan kotak sumber yang merupakan ukuran penuh sumber daya sumber.
 

Persyaratan

   
Klien minimum yang didukung Pembaruan Windows 8 dan Platform untuk Windows 7 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows Server 2012 dan Pembaruan Platform untuk Windows Server 2008 R2 [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header d3d11_1.h
Pustaka D3D11.lib

Lihat juga

ID3D11DeviceContext1