PFND3DDDI_OFFERALLOCATIONSCB fungsi panggilan balik (d3dumddi.h)

Artikel
08/07/2023

Dipanggil oleh driver tampilan mode pengguna untuk menawarkan alokasi memori video untuk digunakan kembali.

Sintaks

PFND3DDDI_OFFERALLOCATIONSCB Pfnd3dddiOfferallocationscb;

HRESULT Pfnd3dddiOfferallocationscb(
  HANDLE hDevice,
  const D3DDDICB_OFFERALLOCATIONS *unnamedParam2
)
{...}

Parameter

hDevice

Handel ke perangkat tampilan (konteks grafis). Runtime Direct3D melewati driver mode pengguna handel ini sebagai anggota hDevice dari struktur D3DDDIARG_CREATEDEVICE pada pembuatan perangkat.

unnamedParam2

pData [in]

Penunjuk ke struktur D3DDDICB_OFFERALLOCATIONS yang menentukan alokasi memori video yang ditawarkan driver.

Menampilkan nilai

Mengembalikan salah satu nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Alokasi berhasil ditawarkan. Catatan: Jika driver tidak perlu memanggil pfnOfferAllocationsCb, driver harus mengembalikan S_OK.
D3DDDIERR_DEVICEREMOVED	Manajer memori video atau driver miniport tampilan tidak dapat menyelesaikan operasi karena peristiwa Berhenti Plug and Play (PnP) atau peristiwa Deteksi dan Pemulihan Batas Waktu (TDR) terjadi. Catatan: Jika kode kesalahan ini dikembalikan, fungsi panggilan driver (biasanya rutinitas pfnOfferResources ) harus mengembalikan kode kesalahan ini ke runtime Direct3D.
E_INVALIDARG	Parameter yang tidak valid disediakan.

Keterangan

Driver tampilan mode pengguna memanggil pfnOfferAllocationsCb untuk memberi tahu subsistem kernel grafis Microsoft DirectX bahwa, setelah menyelesaikan operasi render yang dikirimkan sebelumnya, ia dapat menawarkan memori alokasi untuk digunakan proses lain.

Setelah driver memanggil pfnOfferAllocationsCb untuk menawarkan alokasi untuk digunakan kembali, driver harus memanggil pfnReclaimAllocationsCb sebelum mengunci alokasi atau mengirimkannya untuk operasi penyajian.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8
Server minimum yang didukung	Windows Server 2012
Target Platform	Desktop
Header	d3dumddi.h (termasuk D3dumddi.h)