PFND3DDDI_SETDISPLAYMODE fungsi panggilan balik (d3dumddi.h)

Artikel
08/07/2023

Fungsi SetDisplayMode beralih ke mode tampilan atau primer yang tidak didukung oleh desktop GDI.

Sintaks

PFND3DDDI_SETDISPLAYMODE Pfnd3dddiSetdisplaymode;

HRESULT Pfnd3dddiSetdisplaymode(
  HANDLE hDevice,
  const D3DDDIARG_SETDISPLAYMODE *unnamedParam2
)
{...}

Parameter

hDevice

Handel ke perangkat tampilan (konteks grafis).

unnamedParam2

pData [in]

Penunjuk ke struktur D3DDDIARG_SETDISPLAYMODE yang menentukan parameter untuk mengatur mode tampilan.

Menampilkan nilai

SetDisplayMode mengembalikan S_OK atau hasil kesalahan yang sesuai jika mode tampilan tidak berhasil diatur.

Keterangan

Runtime Microsoft Direct3D memanggil SetDisplayMode untuk beralih ke mode tampilan atau primer yang tidak didukung oleh desktop GDI. Daftar berikut ini menjelaskan contoh utama tersebut:

Utama yang dibuat dengan tampilan 10-bits-per-channel (10:10:10:2) dan merender format target (misalnya, D3DFMT_A2R10G10B10)
Beberapa sampel utama di mana multi-pengambilan sampel dilakukan saat memindai keluar
Utama persisten yang digunakan oleh aplikasi Microsoft DirectX versi 9.L layar penuh

Runtime Direct3D memanggil fungsi CreateResource driver tampilan mode pengguna untuk membuat primer yang akan dipindai. Namun, driver harus memprogram perangkat keras untuk memindai hanya ketika fungsi SetDisplayMode dipanggil. Oleh karena itu, runtime mengatur anggota hResource dan SubResourceIndex dari struktur D3DDDIARG_SETDISPLAYMODE yang diarahkan oleh parameter pData ke primer yang dibuat melalui panggilan ke fungsi CreateResource driver. Driver kemudian harus menerjemahkan primer yang diwakili oleh hResource dan SubResourceIndex ke handel alokasi utama. Setelah driver membuat terjemahan ini, driver harus melewati handel yang dihasilkan dalam panggilan ke fungsi pfnSetDisplayModeCb , yang kemudian memulai panggilan ke fungsi DxgkDdiCommitVidPn driver miniport tampilan.

Driver tampilan mode pengguna dapat mengatur anggota hPrimaryAllocation dari struktur D3DDDICB_SETDISPLAYMODE dalam panggilan ke pfnSetDisplayModeCb untuk memindai alokasi apa pun. Namun, alokasi harus ditandai sebagai primer (yaitu, driver tampilan mode pengguna harus mengatur bendera bit-field Utama di anggota Bendera struktur D3DDDI_ALLOCATIONINFO dalam panggilan ke fungsi pfnAllocateCb untuk membuat alokasi).

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_SETDISPLAYMODE

D3DDDI_DEVICEFUNCS

pfnSetDisplayModeCb

Bagikan melalui