DXGK_BRIGHTNESS_SET fungsi panggilan balik (dispmprt.h)

Artikel
05/23/2024

Fungsi DxgkDdiSetBrightness menetapkan tingkat kecerahan baru.

Sintaks

DXGK_BRIGHTNESS_SET DxgkBrightnessSet;

NTSTATUS DxgkBrightnessSet(
  [in] PVOID Context,
  [in] UCHAR Brightness
)
{...}

Parameter

[in] Context

Handel ke blok konteks yang terkait dengan adaptor tampilan. Fungsi DxgkDdiAddDevice driver miniport tampilan sebelumnya menyediakan handel ini ke subsistem kernel grafis Microsoft DirectX.

[in] Brightness

Nilai tingkat kecerahan yang akan diatur.

Menampilkan nilai

DxgkDdiSetBrightness mengembalikan STATUS_SUCCESS jika berhasil mengatur tingkat kecerahan baru. Jika tidak, ia mengembalikan salah satu kode kesalahan yang ditentukan dalam Ntstatus.h.

Keterangan

Driver monitor memanggil fungsi DxgkDdiSetBrightness driver miniport tampilan untuk mengubah tingkat kecerahan panel tampilan terintegrasi karena alasan berikut:

Pemberitahuan dari Device Power Policy Engine (DPPE) menunjukkan bahwa kebijakan saat ini dimodifikasi atau kebijakan baru berlaku. Kebijakan DPPE baru berlaku pada mulai, lanjutkan, dan sakelar pengguna sistem, serta ketika sumber daya diubah.
Cara yang disukai bagi klien mode pengguna untuk mengontrol kecerahan adalah melalui Windows Management Instrumentation (WMI). Driver monitor mengimplementasikan kontrol kecerahan WMI yang memilih tingkat kecerahan atau mengembalikan tingkat kecerahan ke tingkat yang dipilih oleh kebijakan DPPE yang saat ini aktif. Metode WMI untuk memilih tingkat kecerahan mengambil alih tingkat kebijakan DPPE saat ini hingga perubahan kebijakan DPPE terjadi. Ketika kebijakan DPPE berubah, tingkat DPPE baru diatur.
Untuk kompatibilitas dengan Model Driver Tampilan Windows 2000, driver monitor menerapkan IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS sebagai cara alternatif bagi klien mode pengguna untuk mengontrol kecerahan. Panggilan ke IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS ditangani dengan cara yang sama seperti kontrol kecerahan WMI yang memilih tingkat kecerahan.
Driver monitor menginterpretasikan pemberitahuan hot-key kecerahan dari driver Advanced Configuration dan Power Interface (ACPI) sebagai permintaan pengguna untuk mengubah tingkat kecerahan saat ini. Seperti halnya antarmuka mode pengguna WMI dan IOCTL, perubahan tingkat kecerahan yang dipicu oleh pemberitahuan hot-key mengambil alih kebijakan DPPE saat ini dan tetap berlaku sampai kebijakan DPPE meminta agar nilai kecerahan diatur lagi.

DxgkDdiSetBrightness harus dibuat dapat halaman.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Target Platform	Desktop
Header	dispmprt.h (termasuk Dispmprt.h)
IRQL	PASSIVE_LEVEL

Lihat juga

DxgkDdiAddDevice

IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS

Bagikan melalui