IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS Steuerungscode
Legt die aktuellen Ac- und DC-Hintergrundbeleuchtungsstufen fest.
Um diesen Vorgang auszuführen, rufen Sie die DeviceIoControl-Funktion mit den folgenden Parametern auf.
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
-
hGeräte
-
Ein Handle für das \\.\LCD-Gerät. Um ein Gerätehandle abzurufen, rufen Sie die Funktion CreateFile auf.
-
dwIoControlCode
-
Der Steuerelementcode für den Vorgang. Dieser Wert gibt den spezifischen Vorgang an, der ausgeführt werden soll, und den Typ des Geräts, auf dem er ausgeführt werden soll. Verwenden Sie für diesen Vorgang IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS .
-
lpInBuffer
-
Ein Zeiger auf eine DISPLAY_BRIGHTNESS-Struktur .
-
nInBufferSize
-
Die Größe des Puffers, auf den lpOutBuffer in Bytes verweist.
-
lpOutBuffer
-
Nicht für diesen Vorgang verwendet; auf NULL festgelegt.
-
nOutBufferSize
-
Nicht für diesen Vorgang verwendet; auf 0 festgelegt.
-
lpBytesReturned
-
Ein Zeiger auf eine Variable, die die tatsächliche Anzahl von Bytes empfängt, die von der Funktion im Ausgabepuffer zurückgegeben werden.
Wenn lpOverlappedNULL (nicht überlappende E/A) ist, wird lpBytesReturned intern verwendet und darf nicht NULL sein.
Wenn lpOverlapped nicht NULL (überlappende E/A) ist, kann lpBytesReturnedNULL sein.
-
lpOverlapped
-
Ein Zeiger auf eine ÜBERLAPPENDE Struktur.
Wenn hDevice mit dem flag FILE_FLAG_OVERLAPPED geöffnet wurde, muss lpOverlapped auf eine gültige OVERLAPPED-Struktur verweisen. In diesem Fall wird der Vorgang als überlappender (asynchroner) Vorgang ausgeführt. Wenn das Gerät mit dem FILE_FLAG_OVERLAPPED-Flag geöffnet wurde und lpOverlappedNULL ist, schlägt die Funktion auf unvorhersehbare Weise fehl.
Wenn hDevice geöffnet wurde, ohne das flag FILE_FLAG_OVERLAPPED anzugeben, wird lpOverlapped ignoriert, und DeviceIoControl wird erst zurückgegeben, wenn der Vorgang abgeschlossen wurde oder bis ein Fehler auftritt.
Rückgabewert
Wenn der Vorgang erfolgreich abgeschlossen wurde, gibt DeviceIoControl einen wert ohne Zero zurück.
Wenn der Vorgang fehlschlägt oder aussteht, gibt DeviceIoControl null zurück. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Bemerkungen
Die in den Elementen ucACBrightness und ucDCBrightness der DISPLAY_BRIGHTNESS-Struktur angegebenen Werte müssen zuvor von IOCTL_VIDEO_QUERY_SUPPORTED_BRIGHTNESS zurückgegeben worden sein. Wenn beispielsweise die unterstützten Werte 10, 20, 30, 40, 50, 60, 70, 80, 90 und 100 sind, wäre die Verwendung des Werts 33 ein Fehler.
Die Headerdatei zum Erstellen von Anwendungen, die diese Funktionalität enthalten, Ntddvdeo.h, ist im Microsoft Windows Driver Development Kit (DDK) enthalten. Informationen zum Abrufen des DDK finden Sie unter https://www.microsoft.com/whdc/devtools/ddk/default.mspx.
Alternativ können Sie diesen Steuerelementcode wie folgt definieren:
#define IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS \
CTL_CODE(FILE_DEVICE_VIDEO, 0x127, METHOD_BUFFERED, FILE_ANY_ACCESS)
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista, Windows XP mit SP1 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server 2003 [nur Desktop-Apps] |
| Header |
|