PFND3DDDI_CHECKDIRECTFLIPSUPPORT fungsi panggilan balik (d3dumddi.h)

Artikel
02/26/2024

Dipanggil oleh Desktop Window Manager (DWM) untuk memverifikasi bahwa driver mode pengguna mendukung operasi Balik Langsung, di mana memori video dibalik dengan mulus antara alokasi utama yang dikelola aplikasi dan alokasi utama yang dikelola DWM.

Sintaks

PFND3DDDI_CHECKDIRECTFLIPSUPPORT Pfnd3dddiCheckdirectflipsupport;

HRESULT Pfnd3dddiCheckdirectflipsupport(
  HANDLE hDevice,
  D3DDDIARG_CHECKDIRECTFLIPSUPPORT *unnamedParam2
)
{...}

Parameter

hDevice

Handel ke perangkat tampilan (konteks grafis).

unnamedParam2

pData [masuk, keluar]

Penunjuk ke struktur D3DDDIARG_CHECKDIRECTFLIPSUPPORT yang menentukan parameter untuk operasi.

Menampilkan nilai

Mengembalikan S_OK atau hasil kesalahan yang sesuai jika operasi tidak berhasil dilakukan.

Keterangan

Fungsi ini dipanggil setidaknya sekali sebelum DWM mencoba menyajikan ke swapchain Direct Flip. Ini juga dipanggil setelah setiap perubahan mode terjadi, atau setelah DWM membuat kembali swapchain sendiri karena alasan apa pun.

Driver mode pengguna harus memastikan bahwa alokasi utama aplikasi terkelola dan DWM memiliki sumber daya yang kompatibel berikut:

Sumber daya stereo.
Beberapa format Sampel Anti Aliasing (MSAA).
Format gerimis. Jika swizzle hanya dapat diubah pada setiap interval VSync, pastikan bahwa anggota CheckDirectFlipFlags dari struktur D3DDDI_CHECK_DIRECT_FLIP_FLAGS tidak memiliki nilai D3D11_1DDI_CHECK_DIRECT_FLIP_IMMEDIATE.
Kedua alokasi utama terkelola harus dibuat menggunakan nilai VidPnSourceId yang sama dalam struktur D3DDDI_ALLOCATIONINFO .
Konfigurasi adaptor tampilan ditautkan.

Driver mode pengguna mungkin perlu memanggil driver mode kernel untuk melakukan validasi ini. Untuk melakukan ini, panggil fungsi panggilan balik pfnEscapeCb lalu panggil fungsi DxgkCbGetHandleData untuk mengakses data alokasi sumber daya driver mode kernel.

Karena DWM biasanya membuat perangkatnya sendiri menggunakan tingkat fitur Microsoft Direct3D tertinggi, DWM tidak akan memanggil fungsi ini jika perangkat keras mendukung antarmuka driver perangkat Direct3D (DDI) yang lebih besar dari versi 9.3. Namun, setiap driver Microsoft Direct3D 9 harus menerapkan fungsi ini untuk mengaktifkan pengalaman pengguna Direct Flip.

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)

Lihat juga

D3DDDI_CHECK_DIRECT_FLIP_FLAGS

D3DDDI_DEVICEFUNCS

Bagikan melalui