DXGK_BRIGHTNESS_GET_BACKLIGHT_REDUCTION fungsi panggilan balik (dispmprt.h)
Mengambil tingkat pengurangan lampu latar saat ini yang diterapkan ke panel tampilan terintegrasi.
Sintaks
DXGK_BRIGHTNESS_GET_BACKLIGHT_REDUCTION DxgkBrightnessGetBacklightReduction;
NTSTATUS DxgkBrightnessGetBacklightReduction(
[in] PVOID Context,
[out] DXGK_BACKLIGHT_INFO *BacklightInfo
)
{...}
Parameter
[in] Context
Handel ke blok konteks DxgkDdiAddDevice yang terkait dengan adaptor tampilan. Fungsi driver miniport tampilan sebelumnya menyediakan handel ini ke subsistem kernel grafis DirectX.
[out] BacklightInfo
Nilai jenis DXGK_BACKLIGHT_INFO yang memberikan tingkat absolut pengurangan backlight saat ini.
Nilai kembali
Mengembalikan STATUS_SUCCESS jika berhasil. Jika tidak, ia mengembalikan salah satu kode kesalahan yang didefinisikan dalam Ntstatus.h.
Keterangan
Fungsi ini sebagian besar digunakan untuk tujuan penelusuran kesalahan dan pengujian untuk memastikan pengalaman pengguna yang berkualitas dengan panel tampilan. Driver miniport tampilan harus selalu memberikan informasi yang akurat tentang panel tampilan terintegrasi ketika fungsi ini dipanggil.
Perhatikan bahwa untuk beberapa perangkat keras, nilai nol untuk BacklightInfo-BacklightUsersetting > atau BacklightInfo-BacklightEffective> mungkin tidak sesuai dengan tingkat kecerahan Windows nol persen. Oleh karena itu, sistem operasi memerlukan informasi kecerahan absolut yang diberikan oleh BacklightUsersetting dan BacklightEffective. Jika perangkat keras menggunakan tingkat kecerahan 0 hingga 255, perangkat keras harus mengalikan nilai tersebut dengan 256 untuk memetakannya dengan benar ke rentang 0 hingga 65535 BacklightUsersetting dan BacklightEffective.
Fungsi ini harus dibuat dapat di-pageable.
Menghitung rasio pengurangan lampu latar
Rasio pengurangan lampu latar (BRR) dihitung sebagai (BacklightUsersetting - BacklightEffective) / BacklightUsersetting.Sistem operasi mengasumsikan bahwa, sebagai respons terhadap permintaan tingkat kecerahan baru, driver akan meningkatkan kecerahan piksel dengan faktor BacklightUsersetting / BacklightEffective = 1.0 / (1.0 - BRR).
Sebagai contoh, jika BRR = 0,2, driver biasanya akan meningkatkan kecerahan dengan faktor 1,0 / (1,0 - BRR) = 1,25, jadi piksel apa pun dengan nilai kecerahan di atas 255 * (1,0 - BRR) = 204 akan jenuh. Dengan menggunakan nilai BacklightInfo-GammaRamp> yang disediakan oleh driver, sistem operasi dapat memperkirakan distorsi kecerahan piksel secara lebih akurat untuk gambar tertentu.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 8 |
| Server minimum yang didukung | Windows Server 2012 |
| Target Platform | Desktop |
| Header | dispmprt.h (termasuk Dispmprt.h) |
| IRQL | PASSIVE_LEVEL |