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	D3DX9Effect.h
Pustaka	D3dx9.lib

Lihat juga

ID3DXEffect