LPD3DHAL_CONTEXTCREATECB fungsi panggilan balik (d3dhal.h)

Artikel
02/23/2024

Fungsi D3dContextCreate membuat konteks.

Sintaks

LPD3DHAL_CONTEXTCREATECB Lpd3dhalContextcreatecb;

DWORD Lpd3dhalContextcreatecb(
  LPD3DHAL_CONTEXTCREATEDATA unnamedParam1
)
{...}

Parameter

unnamedParam1

pccd [in]

Menunjuk ke struktur D3DHAL_CONTEXTCREATEDATA yang berisi informasi yang diperlukan untuk membuat konteks dan data yang harus disimpan driver dalam konteks baru.

Menampilkan nilai

D3dContextCreate mengembalikan salah satu kode panggilan balik berikut:

Keterangan

D3dContextCreate harus diimplementasikan di driver yang mendukung Microsoft Direct3D. Ini harus melakukan langkah-langkah berikut:

Inisialisasi konteks driver dengan semua informasi yang diperlukan oleh driver untuk melakukan penyajian. Ini termasuk mengaitkan target penyajian dan buffer kedalaman yang masing-masing anggota lpDDDSLcl dan lpDDSZLcl dari struktur D3DHAL_CONTEXTCREATEDATA pada titik pccd , dengan konteks.
Buat ID konteks unik untuk konteks baru ini dan kembalikan di anggota dwhContext D3DHAL_CONTEXTCREATEDATA. Direct3D menggunakan ID konteks ini di setiap panggilan balik berikutnya yang dilakukannya ke perangkat Direct3D ini. Driver tidak boleh membuat handel konteks nol.
Atur anggota ddrval D3DHAL_CONTEXTCREATEDATA ke DD_OK setelah berhasil, dan ke D3DHAL_OUTOFCONTEXTS jika tidak dapat membuat konteks.
Kembalikan DDHAL_DRIVER_HANDLED.

D3dContextCreate tidak boleh menyimpan penunjuk ke struktur DD_DIRECTDRAW_LOCAL yang diteruskan sebagai anggota lpDDLcl dari D3DHAL_CONTEXTCREATEDATA. Jika driver kemudian memerlukan informasi apa pun yang diakses melalui penunjuk DD_DIRECTDRAW_LOCAL ini, driver harus menyimpan informasi dalam struktur data konteks privat driver.

Status tidak dibagi antar konteks; oleh karena itu, driver harus mempertahankan informasi status penuh untuk setiap konteks. Status ini diubah oleh panggilan berikutnya ke D3dDrawPrimitives2.

Driver harus dapat mereferensikan semua handel tekstur yang dibuat dalam konteks. Driver kemudian dapat membersihkan semua data khusus driver yang terkait dengan tekstur yang dibuat dalam konteks ini ketika panggilan D3dContextDestroy dilakukan.

D3dContextCreate dapat dipanggil dengan PDEV yang dinonaktifkan. PDEV dinonaktifkan atau diaktifkan dengan memanggil fungsi DrvAssertMode driver tampilan. Lihat Mengelola PDEV untuk informasi selengkapnya.