IOCTL_VIDEO_QUERY_SUPPORTED_BRIGHTNESS kode kontrol

Mengambil tingkat backlight yang didukung.

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

BOOL DeviceIoControl(
  (HANDLE) hDevice,                // handle to device
  IOCTL_VIDEO_QUERY_SUPPORTED_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_SUPPORTED_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 menerima array tingkat daya yang tersedia. Buffer ini harus panjangnya 256 byte.

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 (I/O yang tidak tumpang tindih), 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

Setiap elemen dalam array lpOutBuffer memiliki panjang satu byte. Oleh karena itu, setelah pengembalian, parameter lpBytesReturned menunjukkan jumlah tingkat yang didukung. Setiap tingkat adalah nilai dari 0 hingga 100. Semakin besar nilainya, semakin terang lampu latar. Semua tingkat didukung apakah sumber daya adalah AC atau DC.

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_SUPPORTED_BRIGHTNESS \
  CTL_CODE(FILE_DEVICE_VIDEO, 0x125, 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