PFND3DDDI_CREATEDEVICE fungsi panggilan balik (d3dumddi.h)

Fungsi CreateDevice membuat konteks grafis yang direferensikan dalam panggilan berikutnya.

Sintaks

PFND3DDDI_CREATEDEVICE Pfnd3dddiCreatedevice;

HRESULT Pfnd3dddiCreatedevice(
  HANDLE hAdapter,
  D3DDDIARG_CREATEDEVICE *unnamedParam2
)
{...}

Parameter

hAdapter

Handel yang mengidentifikasi adaptor grafis.

unnamedParam2

pCreateData [masuk, keluar]

Penunjuk ke struktur D3DDDIARG_CREATEDEVICE . Pada input, struktur ini berisi informasi yang dapat digunakan driver. Pada output, driver menentukan informasi dalam struktur yang dapat digunakan runtime Microsoft Direct3D.

Menampilkan nilai

CreateDevice mengembalikan salah satu nilai berikut:

Menampilkan kode Deskripsi
S_OK Konteks grafik berhasil dibuat.
E_OUTOFMEMORY CreateDevice tidak dapat mengalokasikan memori yang diperlukan untuk menyelesaikannya.

Keterangan

Perangkat tampilan adalah konteks grafis yang digunakan untuk menyimpan kumpulan status penyajian. Beberapa perangkat dapat dibuat oleh proses yang sama pada adaptor tertentu. Perhatikan bahwa jumlah perangkat tampilan yang dapat secara bersamaan ada hanya dibatasi oleh memori sistem yang tersedia. Artinya, driver tidak dapat melakukan hardcode batas perangkat maksimum.

Umumnya, perangkat tidak bergantung satu sama lain, sehingga sumber daya yang dibuat dalam satu perangkat tidak dapat direferensikan atau diakses oleh sumber daya yang dibuat di perangkat lain. Namun, sumber daya lintas proses adalah pengecualian untuk aturan ini.

Ketika runtime Direct3D memanggil CreateDevice untuk membuat perangkat, runtime tidak membuat utas konteks eksekusi unit pemrosesan grafis (GPU) default untuk perangkat. Driver harus secara eksplisit memanggil fungsi pfnCreateContextCb untuk membuat satu atau beberapa konteks sesuai kebutuhan.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia di Windows Vista dan versi yang lebih baru dari sistem operasi Windows.
Target Platform Desktop
Header d3dumddi.h (termasuk D3dumddi.h)

Lihat juga

D3DDDIARG_CREATEDEVICE

D3DDDI_ADAPTERFUNCS

DestroyDevice