IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS codice di controllo

Articolo
06/12/2023

Imposta i livelli di backlight AC e DC correnti.

Per eseguire questa operazione, chiamare la funzione DeviceIoControl con i parametri seguenti.

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
);

Parametri

hDevice

Handle per il dispositivo \\.\LCD. Per recuperare un handle del dispositivo, chiamare la funzione CreateFile .

dwIoControlCode

Codice di controllo per l'operazione. Questo valore identifica l'operazione specifica da eseguire e il tipo di dispositivo su cui eseguirlo. Usare IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS per questa operazione.

lpInBuffer

Puntatore a una struttura DISPLAY_BRIGHTNESS .

nInBufferSize

Dimensioni del buffer a cui punta lpOutBuffer, in byte.

lpOutBuffer

Non usato con questa operazione; impostato su NULL.

nOutBufferSize

Non usato con questa operazione; impostato su zero.

lpBytesReturned

Puntatore a una variabile che riceve il conteggio effettivo di byte restituiti dalla funzione nel buffer di output.

Se lpOverlapped è NULL (I/O non sovrapposto), lpBytesReturned viene usato internamente e non può essere NULL.

Se lpOverlapped non è NULL (sovrapposto I/O), lpBytesReturned può essere NULL.

lpOverlapped

Puntatore a una struttura OVERLAPPED .

Se hDevice è stato aperto con il flag FILE_FLAG_OVERLAPPED, lpOverlapped deve puntare a una struttura OVERLAPPED valida. In questo caso, l'operazione viene eseguita come operazione sovrapposta (asincrona). Se il dispositivo è stato aperto con il flag FILE_FLAG_OVERLAPPED e lpOverlapped è NULL, la funzione non riesce in modi imprevedibili.

Se hDevice è stato aperto senza specificare il flag FILE_FLAG_OVERLAPPED, lpOverlapped viene ignorato e DeviceIoControl non restituisce fino al completamento dell'operazione o fino a quando non si verifica un errore.

Valore restituito

Se l'operazione viene completata correttamente, DeviceIoControl restituisce un valore diverso da zero.

Se l'operazione ha esito negativo o è in sospeso, DeviceIoControl restituisce zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Osservazioni

I valori specificati nei membri ucACBrightness e ucDCBrightness della struttura DISPLAY_BRIGHTNESS devono essere stati restituiti in precedenza da IOCTL_VIDEO_QUERY_SUPPORTED_BRIGHTNESS. Ad esempio, se i valori supportati sono 10, 20, 30, 40, 50, 60, 70, 80, 90 e 100, quindi usando un valore pari a 33 sarebbe un errore.

Il file di intestazione usato per compilare applicazioni che includono questa funzionalità, Ntdvertitaeo.h, è inclusa nel Microsoft Windows Driver Development Kit (DDK). Per informazioni su come ottenere il DDK, vedere https://www.microsoft.com/whdc/devtools/ddk/default.mspx.

In alternativa, è possibile definire questo codice di controllo come indicato di seguito:

#define IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS \
  CTL_CODE(FILE_DEVICE_VIDEO, 0x127, METHOD_BUFFERED, FILE_ANY_ACCESS)

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista, Windows XP con SP1 [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	Ntdmakeo.h

Vedi anche

Interfaccia di controllo backlight
Deviceiocontrol
DISPLAY_BRIGHTNESS
IOCTL_VIDEO_QUERY_DISPLAY_BRIGHTNESS
IOCTL_VIDEO_QUERY_SUPPORTED_BRIGHTNESS

Condividi tramite