IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS código de control
Establece los niveles de retroiluminación de CA y DC actuales.
Para realizar esta operación, llame a la función DeviceIoControl con los parámetros siguientes.
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
);
Parámetros
-
hDevice
-
Identificador del dispositivo \\.\LCD. Para recuperar un identificador de dispositivo, llame a la función CreateFile .
-
dwIoControlCode
-
Código de control de la operación. Este valor identifica la operación específica que se va a realizar y el tipo de dispositivo en el que se va a realizar. Use IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS para esta operación.
-
lpInBuffer
-
Puntero a una estructura de DISPLAY_BRIGHTNESS .
-
nInBufferSize
-
Tamaño del búfer al que apunta lpOutBuffer, en bytes.
-
lpOutBuffer
-
No se usa con esta operación; se establece en NULL.
-
nOutBufferSize
-
No se usa con esta operación; se establece en cero.
-
lpBytesReturned
-
Puntero a una variable que recibe el recuento real de bytes devueltos por la función en el búfer de salida.
Si lpOverlapped es NULL (E/S no superpuesta), lpBytesReturned se usa internamente y no puede ser NULL.
Si lpOverlapped no es NULL (E/S superpuesta), lpBytesReturned puede ser NULL.
-
lpOverlapped
-
Puntero a una estructura SUPERPUESTA .
Si hDevice se abrió con la marca FILE_FLAG_OVERLAPPED, lpOverlapped debe apuntar a una estructura SUPERPUESTA válida. En este caso, la operación se realiza como una operación superpuesta (asincrónica). Si el dispositivo se abrió con la marca de FILE_FLAG_OVERLAPPED y lpOverlapped es NULL, la función produce un error de maneras impredecibles.
Si hDevice se abrió sin especificar la marca de FILE_FLAG_OVERLAPPED, lpOverlapped se omite y DeviceIoControl no devuelve hasta que se haya completado la operación o hasta que se produzca un error.
Valor devuelto
Si la operación se completa correctamente, DeviceIoControl devuelve un valor distinto de cero.
Si se produce un error en la operación o está pendiente, DeviceIoControl devuelve cero. Para obtener información de error extendida, llame a GetLastError.
Comentarios
Los valores especificados en los miembros ucACBrightness y ucDCBrightness de la estructura DISPLAY_BRIGHTNESS deben haber sido devueltos previamente por IOCTL_VIDEO_QUERY_SUPPORTED_BRIGHTNESS. Por ejemplo, si los valores admitidos son 10, 20, 30, 40, 50, 60, 70, 80, 90 y 100, el uso de un valor de 33 sería un error.
El archivo de encabezado que se usa para compilar aplicaciones que incluyen esta funcionalidad, Ntddvdeo.h, se incluye en el Kit de desarrollo de controladores de Microsoft Windows (DDK). Para obtener información sobre cómo obtener el DDK, vea https://www.microsoft.com/whdc/devtools/ddk/default.mspx.
Como alternativa, puede definir este código de control de la siguiente manera:
#define IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS \
CTL_CODE(FILE_DEVICE_VIDEO, 0x127, METHOD_BUFFERED, FILE_ANY_ACCESS)
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista, Windows XP con SP1 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows Server 2003 [solo aplicaciones de escritorio] |
| Encabezado |
|