struktur D3DHAL_DP2TEXTURESTAGESTATE (d3dhal.h)

Satu atau beberapa struktur D3DHAL_DP2TEXTURESTAGESTATE diurai dari buffer perintah oleh panggilan balik D3dDrawPrimitives2 ketika anggota bCommand struktur D3DHAL_DP2COMMAND diatur ke D3DDP2OP_TEXTURESTAGESTATE, dan digunakan untuk mengatur status tahap tekstur yang sesuai.

Sintaks

typedef struct _D3DHAL_DP2TEXTURESTAGESTATE {
  WORD  wStage;
  WORD  TSState;
  DWORD dwValue;
} D3DHAL_DP2TEXTURESTAGESTATE;

Anggota

wStage

Mengidentifikasi tahap tekstur tempat memperbarui status tekstur. Anggota ini dapat menjadi bilangan bulat dalam rentang 0 hingga 7, dengan tekstur bernomor tertinggi yang paling dekat dengan buffer bingkai.

TSState

Menentukan nilai D3DTEXTURESTAGESTATETYPE yang dijumlahkan yang menentukan status tekstur yang akan diperbarui. Aplikasi DirectX 9.0 dan yang lebih baru dapat menggunakan nilai dalam enumerasi D3DSAMPLERSTATETYPE untuk mengontrol karakteristik status render terkait tekstur sampler. Di DirectX 8.0 dan yang lebih lama, status sampler ini disertakan dalam enumerasi D3DTEXTURESTAGESTATETYPE. Runtime memetakan status sampler mode pengguna (D3DSAMP_Xxx) ke nilai mode kernel D3DTSS_Xxx sehingga driver tidak diperlukan untuk memproses status sampler mode pengguna. Untuk informasi selengkapnya tentang D3DTEXTURESTAGESTATETYPE dan D3DSAMPLERSTATETYPE, lihat dokumentasi DirectX SDK.

dwValue

Menentukan nilai tempat driver harus memperbarui status tekstur yang diidentifikasi oleh TSState .

Keterangan

D3dDrawPrimitives2 harus memproses struktur D3DHAL_DP2TEXTURESTAGESTATE wStateCount dari buffer perintah. Nilai wStateCount ditentukan dalam struktur D3DHAL_DP2COMMAND.

Untuk setiap struktur D3DHAL_DP2TEXTURESTAGESTATE, D3dDrawPrimitives2 harus memperbarui status tekstur internal driver yang terkait dengan tekstur di dwStage untuk mencerminkan nilai baru berdasarkan TSState.

Driver yang tidak mendukung multiteksturing harus menerapkan dukungan hanya untuk tahap tekstur 0.

Gambar berikut menunjukkan sebagian buffer perintah sampel yang berisi perintah D3DDP2OP_TEXTURESTAGESTATE dan tiga struktur D3DHAL_DP2TEXTURESTAGESTATE. Driver harus memperbarui tahap nol dan tiga status tahap tekstur privatnya yang sesuai.

Persyaratan

Persyaratan	Nilai
Header	d3dhal.h (termasuk D3dhal.h)

Lihat juga

D3DDP2OP_TEXTURESTAGESTATE

D3DHAL_DP2COMMAND

D3dDrawPrimitives2