IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS Steuerungscode

Artikel
06/12/2023

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	Ntddvdeo.h

Siehe auch

Backlight-Steuerungsschnittstelle
Deviceiocontrol
DISPLAY_BRIGHTNESS
IOCTL_VIDEO_QUERY_DISPLAY_BRIGHTNESS
IOCTL_VIDEO_QUERY_SUPPORTED_BRIGHTNESS

Freigeben über