Metode IDirect3DDevice9::SetStreamSource (d3d9helper.h)

Artikel
02/29/2024

Mengikat buffer vertex ke aliran data perangkat. Untuk informasi selengkapnya, lihat Mengatur Sumber Stream (Direct3D 9).

Sintaks

HRESULT SetStreamSource(
  [in] UINT                   StreamNumber,
  [in] IDirect3DVertexBuffer9 *pStreamData,
  [in] UINT                   OffsetInBytes,
  [in] UINT                   Stride
);

Parameter

[in] StreamNumber

Jenis: UINT

Menentukan aliran data, dalam rentang dari 0 hingga jumlah maksimum aliran -1.

[in] pStreamData

Jenis: IDirect3DVertexBuffer9*

Arahkan ke antarmuka IDirect3DVertexBuffer9 , mewakili buffer vertex untuk mengikat ke aliran data yang ditentukan.

[in] OffsetInBytes

Jenis: UINT

Offset dari awal aliran ke awal data vertex, dalam byte. Untuk mengetahui apakah perangkat mendukung offset aliran, lihat konstanta D3DDEVCAPS2_STREAMOFFSET di D3DDEVCAPS2.

[in] Stride

Jenis: UINT

Langkah komponen, dalam byte. Lihat Keterangan.

Mengembalikan nilai

Jenis: HRESULT

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

Keterangan

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.

Saat memanggil SetStreamSource, langkah biasanya diperlukan agar sama dengan ukuran vertex. Namun, ada kalanya Anda mungkin ingin menggambar beberapa instans geometri yang sama atau serupa (seperti saat menggunakan instancing untuk menggambar). Untuk kasus ini, gunakan langkah nol untuk memberi tahu runtime untuk tidak menambah offset buffer vertex (yaitu: gunakan data vertex yang sama untuk semua instans). Untuk informasi selengkapnya tentang instancing, lihat Menggambar Beberapa Instans Geometri secara Efisien (Direct3D 9).