struktur DXGKARG_COMMITVIDPN_FLAGS (d3dkmddi.h)

  • Artikel

Struktur DXGKARG_COMMITVIDPN_FLAGS mengidentifikasi detail tentang panggilan ke fungsi DxgkDdiCommitVidPn .

Sintaks

typedef struct _DXGKARG_COMMITVIDPN_FLAGS {
  UINT PathPowerTransition : 1;
  UINT PathPoweredOff : 1;
  UINT Reserved : 30;
} DXGKARG_COMMITVIDPN_FLAGS;

Anggota

PathPowerTransition

Nilai UINT yang menentukan apakah subsistem kernel grafis Microsoft DirectX memanggil fungsi DxgkDdiCommitVidPn untuk mematikan monitor yang terhubung.

Jika PathPowerTransition diatur ke TRUE, driver miniport tampilan dapat mengoptimalkan panggilan ini untuk daya mati (misalnya, driver mungkin menonaktifkan sinkronisasi vertikal). Driver juga harus menyadari bahwa ia mungkin masih menerima panggilan ke fungsi DxgkDdiPresent pada sumber yang terpengaruh.

Mengatur anggota ini setara dengan mengatur bit pertama dari nilai 32-bit (0x00000001).

Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

PathPoweredOff

Nilai UINT yang menentukan apakah subsistem kernel grafis DirectX memanggil DxgkDdiCommitVidPn untuk memberi tahu driver bahwa pengguna mengubah mode.

Jika PathPoweredOff diatur ke TRUE, driver miniport tampilan harus mengharapkan operasi yang didasarkan pada topologi baru. Driver tidak dapat melakukan operasi apa pun yang akan menyebabkan jalur topologi dinyalakan lagi (misalnya, driver tidak dapat mengaktifkan sinkronisasi vertikal) karena monitor sekarang harus dimatikan.

Jika PathPoweredOff diatur ke FALSE, jalur topologi dinyalakan. Driver miniport tampilan harus memprogram perangkat keras untuk operasi saat ini yang didasarkan pada jalur topologi sebelumnya, dan driver harus menerapkan perangkat keras untuk mendukung jalur topologi ini. Mengatur anggota ini setara dengan mengatur bit kedua dari nilai 32-bit (0x00000002).

Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

Reserved

Anggota ini dicadangkan dan harus diatur ke nol. Mengatur anggota ini ke nol setara dengan mengatur 30 bit yang tersisa (0xFFFFFFFC) dari nilai 32-bit ke nol.

Keterangan

Struktur DXGKARG_COMMITVIDPN_FLAGS menyimpan informasi yang dapat digunakan driver miniport tampilan untuk menentukan cara merespons perubahan mode yang diminta. Dengan informasi ini, driver dapat membedakan antara perubahan mode yang terjadi selama aktivitas reguler karena aplikasi meminta perubahan mode, perubahan yang terjadi karena transisi daya, dan perubahan yang terjadi saat monitor dimatikan.

Selama aktivitas reguler, ketika fungsi DxgkDdiCommitVidPn dipanggil, anggota PathPowerTransition dan PathPoweredOff akan menjadi FALSE sehingga driver harus segera menerapkan perubahan mode. Perubahan mode tersebut biasanya dilakukan sebagai peristiwa yang terisolasi. Oleh karena itu, driver tidak perlu melacak status apa pun yang terkait dengan konfigurasi mode sebelumnya.

Jika monitor dimatikan atau dinyalakan, PathPowerTransitionakan true untuk menunjukkan transisi daya. Dalam hal ini, pola umum adalah bahwa monitor akan dimatikan, dan kemudian di lain waktu, konfigurasi asli akan dipulihkan. Ini bisa menjadi beban kerja yang signifikan bagi driver untuk mengatur ulang konfigurasi tampilan sepenuhnya setelah pematian sistem. Selain itu, pengemudi harus terus menyelesaikan operasi DxgkDdiPresent saat monitor dimatikan. Namun, driver dapat mengurangi beban kerjanya ketika panggilan dilakukan ke DxgkDdiCommitVidPn dengan memastikan bahwa monitor yang terlibat dimatikan. Ketika daya dipulihkan, beban kerja driver untuk memulihkan konfigurasi tampilan dengan demikian akan berkurang.

Karena monitor mungkin tidak terhubung secara fisik (pada waktu resume sistem, misalnya), driver tidak boleh mengandalkan Windows untuk melakukan panggilan nanti ke fungsi DxgkDdiSetPowerState untuk mengatur status daya perangkat anak adaptor tampilan. Namun, Windows masih akan meminta agar CRTC diaktifkan. Jika driver tidak menyalakan sinkronisasi vertikal ketika diminta untuk melakukannya oleh manajer mode tampilan (DMM), dan jika pengguna kemudian menyambungkan kembali monitor, tampilan monitor mungkin kosong.

Operasi DxgkDdiPresent tetap harus dihormati oleh pengemudi saat monitor dimatikan. Driver mungkin harus bertindak berdasarkan perubahan mode yang dipicu oleh aplikasi, misalnya untuk melakukan modifikasi pada alur penyajian untuk mempertanyakan perubahan rotasi. Pengaturan PathPowerTransition = FALSE dan PathPoweredOff = TRUE memberi tahu driver bahwa perubahan mode seperti itu telah terjadi. Dalam hal ini, driver tidak boleh menyalakan monitor, tetapi sebaliknya harus memprogram ulang perangkat keras, jika perlu, untuk mengakomodasi perubahan mode sehingga operasi DxgkDdiPresent tambahan dapat diselesaikan. Ketika perubahan mode seperti itu telah dilakukan, dan monitor kemudian dihidupkan kembali, tidak mungkin mode yang terjadi sebelum daya mati akan dipulihkan.

Jika operasi resume sistem dipicu setelah monitor dimatikan untuk operasi penangguhan sistem, driver dapat menerima panggilan DxgkDdiCommitVidPn dengan PathPowerTransition = FALSE dan PathPoweredOff = FALSE sebelum panggilan DxgkDdiCommitVidPn dilakukan dengan PathPowerTransition = TRUE. Situasi ini seharusnya hanya terjadi dengan topologi kosong dan, dalam hal ini, driver tidak boleh menyalakan kembali monitor karena transisi daya belum selesai.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista
Header d3dkmddi.h (termasuk D3dkmddi.h)

Lihat juga

DXGKARG_COMMITVIDPN

DxgkDdiPresent

DxgkDdiSetPowerState