Share via

struktur D3D11_MAPPED_SUBRESOURCE (d3d11.h)

  • Artikel

Menyediakan akses ke data sub sumber daya.

Sintaks

typedef struct D3D11_MAPPED_SUBRESOURCE {
  void *pData;
  UINT RowPitch;
  UINT DepthPitch;
} D3D11_MAPPED_SUBRESOURCE;

Anggota

pData

Jenis: batal*

Arahkan ke data. Ketika ID3D11DeviceContext::Map menyediakan penunjuk, runtime memastikan bahwa penunjuk memiliki perataan tertentu, tergantung pada tingkat fitur berikut:

RowPitch

Jenis: UINT

Pitch baris, atau lebar, atau ukuran fisik (dalam byte) data.

DepthPitch

Jenis: UINT

Pitch kedalaman, atau lebar, atau ukuran fisik (dalam byte) data.

Keterangan

Struktur ini digunakan dalam panggilan ke ID3D11DeviceContext::Map.

Nilai dalam anggota ini memberi tahu Anda berapa banyak data yang bisa Anda lihat:

  • pData menunjuk ke baris 0 dan iringan kedalaman 0.
  • RowPitch berisi nilai yang ditambahkan runtime ke pData untuk berpindah dari baris ke baris, di mana setiap baris berisi beberapa piksel.
  • DepthPitch berisi nilai yang ditambahkan runtime ke pData untuk berpindah dari ilis kedalaman ke ilis kedalaman, di mana setiap ilis kedalaman berisi beberapa baris.
Ketika RowPitch dan DepthPitch tidak sesuai untuk jenis sumber daya, runtime mungkin mengatur nilainya ke 0. Jadi, jangan gunakan nilai-nilai ini untuk apa pun selain iterasi di atas baris dan kedalaman. Berikut adalah beberapa contohnya:
  • Untuk Buffer dan Texture1D, runtime menetapkan nilai yang bukan 0 ke RowPitch dan DepthPitch. Misalnya, jika Buffer berisi 8 byte, runtime menetapkan nilai ke RowPitch dan DepthPitch yang lebih besar dari atau sama dengan 8.
  • Untuk Texture2D, runtime masih menetapkan nilai yang bukan 0 ke DepthPitch, dengan asumsi bahwa bidang tidak digunakan.
Catatan Runtime mungkin menetapkan nilai ke RowPitch dan DepthPitch yang lebih besar dari yang diantisipasi karena mungkin ada padding antara baris dan kedalaman.
 

Persyaratan

Persyaratan Nilai
Header d3d11.h

Lihat juga

Struktur Sumber Daya