IOCTL_VIDEO_QUERY_DISPLAY_BRIGHTNESS kode kontrol

[Kode kontrol ini tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Dukungan untuk kode kontrol ini dihapus di Windows Server 2008 dan Windows Vista. Gunakan kelas WmiMonitorBrightness sebagai gantinya.]

Mengambil tingkat lampu latar AC dan DC saat ini dan status daya saat ini.

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

BOOL DeviceIoControl(
  (HANDLE) hDevice,                // handle to device
  IOCTL_VIDEO_QUERY_DISPLAY_BRIGHTNESS,  // dwIoControlCode
  NULL,                            // lpInBuffer
  0,                               // nInBufferSize
  (LPVOID) lpOutBuffer,            // output buffer
  (DWORD) nOutBufferSize,          // size of output buffer
  (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_QUERY_DISPLAY_BRIGHTNESS untuk operasi ini.

lpInBuffer

Tidak digunakan dengan operasi ini; atur ke NULL.

nInBufferSize

Tidak digunakan dengan operasi ini; atur ke nol.

lpOutBuffer

Penunjuk ke buffer yang akan menerima struktur DISPLAY_BRIGHTNESS .

nOutBufferSize

Ukuran buffer output, dalam byte.

lpBytesReturned

Penunjuk ke variabel yang menerima ukuran, dalam byte, dari data output yang dikembalikan.

Jika buffer output terlalu kecil untuk mengembalikan data apa pun, maka panggilan gagal, GetLastError mengembalikan kode kesalahan ERROR_INSUFFICIENT_BUFFER, dan jumlah byte yang dikembalikan adalah nol.

Jika buffer output terlalu kecil untuk menyimpan semua data tetapi dapat menyimpan beberapa entri, maka sistem operasi mengembalikan sebanyak yang cocok, panggilan gagal, GetLastError mengembalikan kode kesalahan ERROR_MORE_DATA, dan lpBytesReturned menunjukkan jumlah data yang dikembalikan. Aplikasi Anda harus memanggil DeviceIoControl lagi dengan operasi yang sama, menentukan titik awal baru.

Jika lpOverlapped adalah NULL (tidak tumpang tindih I/O), lpBytesReturned tidak boleh NULL.

Jika lpOverlapped bukan NULL (Tumpang tindih I/O), lpBytesReturned bisa NULL. Jika ini adalah operasi yang tumpang tindih, Anda dapat mengambil jumlah byte yang dikembalikan dengan memanggil fungsi GetOverlappedResult . Jika hDevice dikaitkan dengan port penyelesaian I/O, Anda bisa mendapatkan jumlah byte yang dikembalikan dengan memanggil fungsi GetQueuedCompletionStatus .

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

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_QUERY_DISPLAY_BRIGHTNESS \
  CTL_CODE(FILE_DEVICE_VIDEO, 0x126, METHOD_BUFFERED, FILE_ANY_ACCESS)

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP dengan SP1 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Akhir dukungan klien	Windows XP dengan SP2
Akhir dukungan server	Windows Server 2003 R2
Header	Ntddvdeo.h

Lihat juga

Antarmuka Kontrol Backlight

DeviceIoControl

DISPLAY_BRIGHTNESS

IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS