Metode ID3D10Device::SOSetTargets (d3d10.h)

Atur buffer output target untuk tahap StreamOutput , yang memungkinkan/menonaktifkan alur untuk mengalirkan data.

Sintaks

void SOSetTargets(
  [in] UINT         NumBuffers,
  [in] ID3D10Buffer * const *ppSOTargets,
  [in] const UINT   *pOffsets
);

Parameter

[in] NumBuffers

Jenis: UINT

Jumlah buffer yang akan diikat ke perangkat. Maksimal empat buffer output dapat diatur. Jika kurang dari empat ditentukan oleh panggilan, slot buffer yang tersisa diatur ke NULL. Lihat Keterangan.

[in] ppSOTargets

Jenis: ID3D10Buffer*

Array buffer output (lihat ID3D10Buffer) untuk mengikat ke perangkat. Buffer harus dibuat dengan bendera D3D10_BIND_STREAM_OUTPUT .

[in] pOffsets

Jenis: const UINT*

Array offset ke buffer output dari ppSOTargets, satu offset untuk setiap buffer. Nilai offset harus dalam byte.

Nilai kembali

Tidak ada

Keterangan

Panggil ID3D10Device::SOSetTargets (sebelum panggilan gambar) untuk melakukan streaming data keluar; panggil SOSetTargets dengan NULL untuk menghentikan streaming data. Misalnya, lihat Latihan 01 dari lokakarya GDC 2007, yang mengatur rendertarget output aliran sebelum memanggil metode gambar dalam fungsi RenderInstanceToStream.

Offset -1 akan menyebabkan buffer output aliran ditambahkan, berlanjut setelah lokasi terakhir yang ditulis ke buffer dalam output aliran sebelumnya.

Memanggil metode ini menggunakan buffer yang saat ini terikat untuk menulis akan secara efektif mengikat NULL sebagai gantinya karena buffer tidak dapat diikat sebagai input dan output pada saat yang sama.

Lapisan Debug akan menghasilkan peringatan setiap kali sumber daya dicegah terikat secara bersamaan sebagai input dan output, tetapi ini tidak akan mencegah data yang tidak valid digunakan oleh runtime.

Metode ini tidak akan menyimpan referensi ke antarmuka yang diteruskan. Untuk alasan itu, aplikasi harus berhati-hati untuk tidak merilis antarmuka yang saat ini digunakan oleh perangkat.

Persyaratan

Persyaratan Nilai
Target Platform Windows
Header d3d10.h
Pustaka D3D10.lib

Lihat juga

ID3D10Device Interface