Metode IDirect3DDevice9::GetStreamSource (d3d9.h)

Artikel
03/04/2024

Mengambil buffer vertex yang terikat ke aliran data yang ditentukan.

Sintaks

HRESULT GetStreamSource(
  UINT                   StreamNumber,
  IDirect3DVertexBuffer9 **ppStreamData,
  UINT                   *pOffsetInBytes,
  UINT                   *pStride
);

Parameter

StreamNumber

Ketik: [in] UINT

Menentukan aliran data, dalam rentang dari 0 hingga jumlah maksimum aliran dikurangi satu.

ppStreamData

Jenis: [in, out] IDirect3DVertexBuffer9**

Alamat penunjuk ke antarmuka IDirect3DVertexBuffer9 , mewakili buffer vertex yang dikembalikan terikat ke aliran data yang ditentukan.

pOffsetInBytes

Jenis: [out]UINT*

Pointer yang berisi offset dari awal aliran ke awal data vertex. Offset diukur dalam byte. Lihat Keterangan.

pStride

Jenis: [out] UINT*

Penunjuk ke langkah komponen yang dikembalikan, dalam byte. Lihat Keterangan.

Nilai kembali

Jenis: HRESULT

Jika metode berhasil, nilai yang dikembalikan D3D_OK. Jika metode gagal, nilai yang dikembalikan dapat D3DERR_INVALIDCALL.

Keterangan

Aliran didefinisikan sebagai array data komponen yang seragam, di mana setiap komponen terdiri dari satu atau beberapa elemen yang mewakili satu entitas seperti posisi, normal, warna, dan sebagainya.

Ketika shader vertex FVF digunakan, langkah aliran vertex harus cocok dengan ukuran puncak, dihitung dari FVF. Ketika deklarasi digunakan, langkah harus lebih besar dari atau sama dengan ukuran aliran yang dihitung dari deklarasi.

Memanggil metode ini meningkatkan jumlah referensi internal pada antarmuka IDirect3DVertexBuffer9 . Kegagalan untuk memanggil IUnknown::Release setelah selesai menggunakan antarmuka IDirect3DVertexBuffer9 ini menghasilkan kebocoran memori.