Bagikan melalui


PFND3DDDI_OFFERALLOCATIONSCB fungsi panggilan balik (d3dumddi.h)

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

Sintaksis

PFND3DDDI_OFFERALLOCATIONSCB Pfnd3dddiOfferallocationscb;

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

Parameter

hDevice

Handel ke perangkat tampilan (konteks grafis). Runtime Direct3D melewati pengandar mode pengguna, handel ini sebagai hDevice anggota struktur D3DDDIARG_CREATEDEVICE saat pembuatan perangkat.

unnamedParam2

pData [in]

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

Mengembalikan nilai

Mengembalikan salah satu nilai berikut.

Mengembalikan 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 Stop Plug and Play (PnP) atau terjadi peristiwa Deteksi dan Pemulihan Batas Waktu (TDR).
Catatan: Jika kode kesalahan ini dikembalikan, fungsi panggilan driver (biasanya pfnOfferResources rutin) harus mengembalikan kode kesalahan ini ke runtime Direct3D.
E_INVALIDARG Parameter yang tidak valid disediakan.

Komentar

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 proses lain yang akan digunakan.

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

Persyaratan

Syarat Nilai
klien minimum yang didukung Windows 8
server minimum yang didukung Windows Server 2012
Platform Target Desktop
Header d3dumddi.h (termasuk D3dumddi.h)

Lihat juga

D3DDDIARG_CREATEDEVICE

D3DDDICB_OFFERALLOCATIONS

D3DDDI_DEVICECALLBACKS

pfnOfferResources

pfnReclaimAllocationsCb