ID3DXEffect::Begin method
Memulai teknik aktif.
Sintaks
HRESULT Begin(
[out] UINT *pPasses,
[in] DWORD Flags
);
Parameter
-
pPasses [out]
-
Jenis: UINT*
Penunjuk ke nilai yang dikembalikan yang menunjukkan jumlah pass yang diperlukan untuk merender teknik saat ini.
-
Bendera [in]
-
Jenis: DWORD
DWORD yang menentukan apakah status dimodifikasi oleh efek disimpan dan dipulihkan. Nilai default 0 menentukan bahwa ID3DXEffect::Begin dan ID3DXEffect::End akan menyimpan dan memulihkan semua status yang dimodifikasi oleh efek (termasuk konstanta shader piksel dan vertex). Bendera yang valid dapat dilihat di Status Efek Simpan dan Pulihkan Bendera.
Menampilkan nilai
Jenis: HRESULT
Jika metode berhasil, nilai yang dikembalikan adalah D3D_OK. Jika metode gagal, nilai yang dikembalikan bisa menjadi salah satu dari yang berikut: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA.
Keterangan
Aplikasi menetapkan satu teknik aktif dalam sistem efek dengan memanggil ID3DXEffect::Begin. Sistem efek merespons dengan menangkap semua status alur yang dapat diubah oleh teknik dalam blok status. Aplikasi menandakan akhir teknik dengan memanggil ID3DXEffect::End, yang menggunakan blok status untuk memulihkan status asli. Oleh karena itu, sistem efek mengurus status penghematan ketika teknik menjadi aktif dan memulihkan status ketika teknik berakhir. Jika Anda memilih untuk menonaktifkan fungsionalitas simpan dan pulihkan ini, lihat D3DXFX_DONOTSAVESAMPLERSTATE.
Dalam pasangan ID3DXEffect::Begin dan ID3DXEffect::End , aplikasi menggunakan ID3DXEffect::BeginPass untuk mengatur pass aktif, ID3DXEffect::CommitChanges jika ada perubahan status yang terjadi setelah pass diaktifkan, dan ID3DXEffect::EndPass untuk mengakhiri pass aktif.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Header |
|
| Pustaka |
|
Lihat juga