IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS código de controle

  • Artigo

Define os níveis atuais de backlight de AC e DC.

Para executar essa operação, chame a função DeviceIoControl com os parâmetros a seguir.

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

Um identificador para o dispositivo \\.\LCD. Para recuperar um identificador de dispositivo, chame a função CreateFile .

Dwiocontrolcode

O código de controle para a operação. Esse valor identifica a operação específica a ser executada e o tipo de dispositivo no qual executá-la. Use IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS para esta operação.

lpInBuffer

Um ponteiro para uma estrutura DISPLAY_BRIGHTNESS .

nInBufferSize

O tamanho do buffer apontado por lpOutBuffer, em bytes.

Lpoutbuffer

Não usado com esta operação; definido como NULL.

nOutBufferSize

Não usado com esta operação; definido como zero.

Lpbytesreturned

Um ponteiro para uma variável que recebe a contagem real de bytes retornados pela função no buffer de saída.

Se lpOverlapped for NULL (E/S não sobreposta), lpBytesReturned será usado internamente e não poderá ser NULL.

Se lpOverlapped não for NULL (E/S sobreposta), lpBytesReturned poderá ser NULL.

Lpoverlapped

Um ponteiro para uma estrutura OVERLAPPED .

Se hDevice tiver sido aberto com o sinalizador FILE_FLAG_OVERLAPPED, lpOverlapped deverá apontar para uma estrutura OVERLAPPED válida. Nesse caso, a operação é executada como uma operação sobreposta (assíncrona). Se o dispositivo foi aberto com o sinalizador FILE_FLAG_OVERLAPPED e lpOverlapped for NULL, a função falhará de maneiras imprevisíveis.

Se hDevice foi aberto sem especificar o sinalizador FILE_FLAG_OVERLAPPED, lpOverlapped será ignorado e DeviceIoControl não retornará até que a operação seja concluída ou até que ocorra um erro.

Valor retornado

Se a operação for concluída com êxito, DeviceIoControl retornará um valor diferente de zero.

Se a operação falhar ou estiver pendente, DeviceIoControl retornará zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Os valores especificados nos membros ucACBrightness e ucDCBrightness da estrutura DISPLAY_BRIGHTNESS devem ter sido retornados anteriormente por IOCTL_VIDEO_QUERY_SUPPORTED_BRIGHTNESS. Por exemplo, se os valores com suporte forem 10, 20, 30, 40, 50, 60, 70, 80, 90 e 100, usar um valor de 33 será um erro.

O arquivo de cabeçalho usado para criar aplicativos que incluem essa funcionalidade, Ntddvdeo.h, está incluído no DDK (Microsoft Windows Driver Development Kit). Para obter informações sobre como obter o DDK, consulte https://www.microsoft.com/whdc/devtools/ddk/default.mspx.

Como alternativa, você pode definir esse código de controle da seguinte maneira:

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

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows Vista, Windows XP com SP1 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
 Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho
Ntddvdeo.h

Confira também

Interface de controle de luz de fundo

Deviceiocontrol

DISPLAY_BRIGHTNESS

IOCTL_VIDEO_QUERY_DISPLAY_BRIGHTNESS

IOCTL_VIDEO_QUERY_SUPPORTED_BRIGHTNESS