struktur DXGK_DIAGNOSTIC_PSR (dispmprt.h)

Diagnostik yang menunjukkan bahwa panel yang terhubung melalui target di bidang TargetId di struktur DXGK_DIAGNOSTIC_HEADER telah memasuki atau keluar dari status refresh mandiri panel (PSR).

Sintaks

typedef struct _DXGK_DIAGNOSTIC_PSR {
  DXGK_DIAGNOSTIC_HEADER Header;
  union {
    DXGK_DIAGNOSTIC_PSR_REFRESH_REASON RefreshReason;
    UINT                               Value;
  };
} DXGK_DIAGNOSTIC_PSR;

Anggota

Header

Struktur DXGK_DIAGNOSTIC_HEADER yang menunjukkan jenis diagnostik apa yang sedang dilaporkan.

RefreshReason

Sekumpulan DXGK_DIAGNOSTIC_PSR_REFRESH_REASON bit-field yang menunjukkan alasan atau alasan untuk keluar dari PSR atau, jika tidak ada yang ditetapkan, menunjukkan bahwa target memasuki PSR.

Value

Nilai PSR.

Keterangan

Ketika panel memasukkan refresh mandiri, driver harus mengirim diagnostik ini dengan tidak ada bidang bit yang diatur di bidang RefreshReason .

Ketika panel perlu keluar dari refresh mandiri untuk memperbarui konten, driver harus mengirim diagnostik ini dengan setidaknya salah satu bidang bit dalam RefreshReason, menunjukkan alasan untuk keluar dari PSR. Jika beberapa faktor menyebabkan PSR keluar, driver harus mencoba mengatur semua alasan bidang bit yang sesuai. Namun, lebih penting bahwa bendera tidak boleh diatur jika alasannya bukan pemicu untuk keluar dari PSR, daripada menangkap semua alasan yang memicu keluarnya. Ini karena setelah PSR keluar, driver seharusnya tidak kemudian melaporkan alasan tambahan bahwa PSR akan keluar sehingga di bawah pelaporan valid, selama setidaknya satu alasan disediakan.

Jika panel dan driver mendukung PSR2, di mana pembaruan tidak memerlukan bingkai penuh untuk dikirim ke panel untuk menyegarkan bagian yang lebih kecil, pembaruan tersebut masih harus dilaporkan ke OS saat keluar dari PSR. Misalnya, jika tampilan dalam PSR dan bentuk kursor diubah tanpa pembaruan lain, driver harus dapat mengirim sebagian kecil dari bingkai penuh piksel, kemungkinan hanya garis yang berisi kursor. Dalam hal ini, driver masih harus melaporkan bahwa PSR telah keluar, dengan alasan CursorUpdate. Dalam rilis selanjutnya, bidang diagnostik tambahan dapat ditambahkan untuk membedakan pembaruan parsial dan penuh.

Persyaratan

Persyaratan	Nilai
Header	dispmprt.h