PFND3DDDI_OFFERALLOCATIONS2CB fungsi panggilan balik (d3dumddi.h)

Artikel
02/26/2024

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

Sintaks

PFND3DDDI_OFFERALLOCATIONS2CB Pfnd3dddiOfferallocations2cb;

HRESULT Pfnd3dddiOfferallocations2cb(
  HANDLE hDevice,
  const D3DDDICB_OFFERALLOCATIONS2 *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_OFFERALLOCATIONS2 yang menentukan alokasi memori video yang ditawarkan driver.

Nilai kembali

Mengembalikan salah satu nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Alokasi berhasil ditawarkan. Catatan: Jika driver tidak perlu memanggil pfnOfferAllocations2Cb , 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 pfnOfferAllocations2Cb 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 pfnOfferAllocations2Cb untuk menawarkan alokasi untuk digunakan kembali, driver harus memanggil pfnReclaimAllocations3Cb sebelum mengunci alokasi atau mengirimkannya untuk operasi penyajian.

fungsi pfnOfferAllocations2Cb identik dengan pfnOfferAllocationsCb, kecuali bahwa fungsi tersebut memperhitungkan bendera melalui parameter pData.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 10
Server minimum yang didukung	Server Windows 2016
Target Platform	Windows
Header	d3dumddi.h (termasuk D3dumddi.h)