IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS kode kontrol

Artikel
06/12/2023

Mengatur tingkat lampu latar AC dan DC saat ini.

Untuk melakukan operasi ini, panggil fungsi DeviceIoControl dengan parameter berikut.

BOOL DeviceIoControl(
  (HANDLE) hDevice,            // handle to device
  IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS, // dwIoControlCode
  (LPVOID) lpInBuffer,         // input buffer
  (DWORD) nInBufferSize,       // size of the input buffer
  NULL,                        // lpOutBuffer
  0,                           // nOutBufferSize 
  (LPDWORD) lpBytesReturned,   // number of bytes returned
  (LPOVERLAPPED) lpOverlapped  // OVERLAPPED structure
);

Parameter

hDevice

Handel ke perangkat \\.\LCD. Untuk mengambil handel perangkat, panggil fungsi CreateFile .

dwIoControlCode

Kode kontrol untuk operasi. Nilai ini mengidentifikasi operasi tertentu yang akan dilakukan dan jenis perangkat untuk melakukannya. Gunakan IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS untuk operasi ini.

lpInBuffer

Penunjuk ke struktur DISPLAY_BRIGHTNESS .

nInBufferSize

Ukuran buffer yang diacu oleh lpOutBuffer, dalam byte.

lpOutBuffer

Tidak digunakan dengan operasi ini; atur ke NULL.

nOutBufferSize

Tidak digunakan dengan operasi ini; atur ke nol.

lpBytesReturned

Penunjuk ke variabel yang menerima jumlah byte aktual yang dikembalikan oleh fungsi dalam buffer output.

Jika lpOverlapped adalah NULL (I/O yang tidak tumpang tindih), lpBytesReturned digunakan secara internal dan tidak boleh NULL.

Jika lpOverlapped bukan NULL (Tumpang tindih I/O), lpBytesReturned bisa NULL.

lpOverlapped

Penunjuk ke struktur YANG TUMPANG TINDIH .

Jika hDevice dibuka dengan bendera FILE_FLAG_OVERLAPPED, lpOverlapped harus menunjuk ke struktur TUMPANG TINDIH yang valid. Dalam hal ini, operasi dilakukan sebagai operasi yang tumpang tindih (asinkron). Jika perangkat dibuka dengan bendera FILE_FLAG_OVERLAPPED dan lpOverlapped adalah NULL, fungsi gagal dengan cara yang tidak dapat diprediksi.

Jika hDevice dibuka tanpa menentukan bendera FILE_FLAG_OVERLAPPED, lpOverlapped diabaikan dan DeviceIoControl tidak kembali sampai operasi selesai, atau sampai terjadi kesalahan.

Mengembalikan nilai

Jika operasi berhasil diselesaikan, DeviceIoControl mengembalikan nilai bukan nol.

Jika operasi gagal atau tertunda, DeviceIoControl mengembalikan nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Nilai yang ditentukan dalam anggota ucACBrightness dan ucDCBrightness dari struktur DISPLAY_BRIGHTNESS sebelumnya harus dikembalikan oleh IOCTL_VIDEO_QUERY_SUPPORTED_BRIGHTNESS. Misalnya, jika nilai yang didukung adalah 10, 20, 30, 40, 50, 60, 70, 80, 90, dan 100, maka menggunakan nilai 33 akan menjadi kesalahan.

File header yang digunakan untuk membangun aplikasi yang menyertakan fungsionalitas ini, Ntddvdeo.h, disertakan dalam Microsoft Windows Driver Development Kit (DDK). Untuk informasi tentang mendapatkan DDK, lihat https://www.microsoft.com/whdc/devtools/ddk/default.mspx.

Atau, Anda dapat menentukan kode kontrol ini sebagai berikut:

#define IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS \
  CTL_CODE(FILE_DEVICE_VIDEO, 0x127, METHOD_BUFFERED, FILE_ANY_ACCESS)

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista, Windows XP dengan SP1 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	Ntddvdeo.h

Lihat juga

Antarmuka Kontrol Backlight
DeviceIoControl
DISPLAY_BRIGHTNESS
IOCTL_VIDEO_QUERY_DISPLAY_BRIGHTNESS
IOCTL_VIDEO_QUERY_SUPPORTED_BRIGHTNESS

Bagikan melalui