IOCTL_VIDEO_QUERY_DISPLAY_BRIGHTNESS-Steuerungscode

[Dieser Steuerungscode ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Die Unterstützung für diesen Steuerungscode wurde in Windows Server 2008 und Windows Vista entfernt. Verwenden Sie stattdessen die WmiMonitorBrightness-Klasse .]

Ruft die aktuellen Wechselstrom- und DC-Hintergrundbeleuchtungsstufen und den aktuellen Energiezustand ab.

Um diesen Vorgang auszuführen, rufen Sie die DeviceIoControl-Funktion mit den folgenden Parametern auf.

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

Ein Handle für das \\.\LCD-Gerät. Um ein Gerätehandle abzurufen, rufen Sie die CreateFile-Funktion auf.

dwIoControlCode

Der Steuerelementcode für den Vorgang. Dieser Wert gibt den auszuführenden Vorgang und den Typ des Geräts an, auf dem er ausgeführt werden soll. Verwenden Sie für diesen Vorgang IOCTL_VIDEO_QUERY_DISPLAY_BRIGHTNESS .

lpInBuffer

Nicht für diesen Vorgang verwendet; auf NULL festgelegt.

nInBufferSize

Nicht für diesen Vorgang verwendet; auf 0 (null) festgelegt.

lpOutBuffer

Ein Zeiger auf einen Puffer, der eine DISPLAY_BRIGHTNESS-Struktur empfängt.

nOutBufferSize

Die Größe des Ausgabepuffers in Bytes.

lpBytesReturned

Ein Zeiger auf eine Variable, die die Größe der zurückgegebenen Ausgabedaten in Bytes empfängt.

Wenn der Ausgabepuffer zu klein ist, um Daten zurückzugeben, schlägt der Aufruf fehl, GetLastError gibt den Fehlercode ERROR_INSUFFICIENT_BUFFER zurück, und die zurückgegebene Byteanzahl ist null.

Wenn der Ausgabepuffer zu klein ist, um alle Daten aufzunehmen, aber einige Einträge enthalten kann, gibt das Betriebssystem den passenden Wert zurück, der Aufruf schlägt fehl, GetLastError gibt den Fehlercode ERROR_MORE_DATA zurück, und lpBytesReturned gibt die zurückgegebene Datenmenge an. Ihre Anwendung sollte DeviceIoControl erneut mit demselben Vorgang aufrufen und einen neuen Ausgangspunkt angeben.

Wenn lpOverlappedNULL (nicht überlappende E/A) ist, kann lpBytesReturned nicht NULL sein.

Wenn lpOverlapped nicht NULL ist (überlappende E/A), kann lpBytesReturnedNULL sein. Wenn es sich um einen überlappenden Vorgang handelt, können Sie die Anzahl der zurückgegebenen Bytes abrufen, indem Sie die GetOverlappedResult-Funktion aufrufen. Wenn hDevice einem E/A-Abschlussport zugeordnet ist, können Sie die Anzahl der zurückgegebenen Bytes abrufen, indem Sie die GetQueuedCompletionStatus-Funktion aufrufen.

lpOverlapped

Ein Zeiger auf eine OVERLAPPED-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 flag FILE_FLAG_OVERLAPPED 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 ist oder ein Fehler auftritt.

Rückgabewert

Wenn der Vorgang erfolgreich abgeschlossen wird, gibt DeviceIoControl einen Wert ungleich null 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 Headerdatei, die zum Erstellen von Anwendungen verwendet wird, 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_QUERY_DISPLAY_BRIGHTNESS \
  CTL_CODE(FILE_DEVICE_VIDEO, 0x126, METHOD_BUFFERED, FILE_ANY_ACCESS)

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP mit SP1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Ende des Supports (Client)	Windows XP mit SP2
Ende des Supports (Server)	Windows Server 2003 R2
Header	Ntddvdeo.h

Siehe auch

Backlight-Steuerungsschnittstelle

Deviceiocontrol

DISPLAY_BRIGHTNESS

IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS