PFND3DDDI_SETDISPLAYMODE fungsi panggilan balik (d3dumddi.h)

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.

Mengembalikan 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

   
Klien minimum yang didukung Tersedia di Windows Vista dan versi sistem operasi Windows yang lebih baru.
Target Platform Desktop
Header d3dumddi.h (termasuk D3dumddi.h)

Lihat juga

D3DDDIARG_SETDISPLAYMODE

D3DDDI_DEVICEFUNCS

pfnSetDisplayModeCb