DXGKCB_MULTIPLANEOVERLAYDISABLED fungsi panggilan balik (d3dkmddi.h)

  • Artikel

Driver miniport tampilan mode kernel DXGKCB_MULTIPLANEOVERLAYDISABLED untuk menunjukkan bahwa konfigurasi multiplane overlay (MPO) saat ini tidak lagi didukung pada VidPnSourceId yang ditentukan.

Sintaks

DXGKCB_MULTIPLANEOVERLAYDISABLED DxgkcbMultiplaneoverlaydisabled;

void DxgkcbMultiplaneoverlaydisabled(
  [in] IN_CONST_HANDLE hAdapter,
  [in] UINT VidPnSourceId
)
{...}

Parameter

[in] hAdapter

Tangani ke adaptor tempat konfigurasi perangkat keras MPO saat ini tidak lagi didukung.

[in] VidPnSourceId

VidPnSourceId tempat konfigurasi perangkat keras MPO saat ini tidak lagi didukung.

Menampilkan nilai

Tidak ada

Keterangan

DXGKCB_MULTIPLANEOVERLAYDISABLED memberi tahu Desktop Windows Manager (DWM) bahwa konfigurasi MPO saat ini tidak lagi didukung, memungkinkan DWM untuk kembali ke komposisi.

Permintaan ini diproses secara asinkron dan dapat ditunda oleh beberapa bingkai. Disarankan untuk memanggil fungsi ini hanya dalam kasus luar biasa seperti skenario berikut:

  • Perubahan tampilan atau peristiwa hot plug pada satu output membuatnya tidak lagi mungkin untuk terus mendukung konfigurasi MPO yang diterapkan ke monitor yang berbeda. Dalam hal ini, driver dapat menonaktifkan bidang overlay pada monitor. Pengguna akan melihat artefak yang terlihat tetapi akhirnya harus diperbairah oleh DWM.

  • MPO harus dinonaktifkan karena masalah termal. Dalam hal ini, driver tidak perlu segera menonaktifkan MPO, tetapi dapat menunggu sampai DWM menerima pemberitahuan dan memerlukan dukungan MPO (yang harus ditunjukkan KMD tidak didukung karena masalah termal). Pada saat itu, DWM akan menonaktifkan MPO dan mulai menyusun.

Untuk kasus umum, driver seharusnya mencegah konfigurasi overlay multiplane yang tidak kompatibel dengan merespons DxgkDdiCheckMultiplaneOverlaySupport3 dengan benar.

DXGKCB_XXX diimplementasikan oleh Dxgkrnl. Untuk menggunakan fungsi panggilan balik ini, panggil DxgkCbMultiPlaneOverlayDisabled melalui DXGKRNL_INTERFACE.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 10, versi 1607 (WDDM 2.1)
Target Platform Windows
Header d3dkmddi.h
IRQL <= PASSIVE_LEVEL

Lihat juga

DxgkDdiCheckMultiplaneOverlaySupport3

DXGKRNL_INTERFACE