code de contrôle IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS

Définit les niveaux actuels de rétro-éclairage CA et DC.

Pour effectuer cette opération, appelez la fonction DeviceIoControl avec les paramètres suivants.

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

Paramètres

hDevice

Handle de l’appareil \\.\LCD. Pour récupérer un handle d’appareil, appelez la fonction CreateFile .

dwIoControlCode

Code de contrôle pour l’opération. Cette valeur identifie l’opération spécifique à effectuer et le type d’appareil sur lequel l’effectuer. Utilisez IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS pour cette opération.

lpInBuffer

Pointeur vers une structure DISPLAY_BRIGHTNESS .

nInBufferSize

Taille de la mémoire tampon pointée par lpOutBuffer, en octets.

lpOutBuffer

Non utilisé avec cette opération ; défini sur NULL.

nOutBufferSize

Non utilisé avec cette opération ; défini sur zéro.

lpBytesReturned

Pointeur vers une variable qui reçoit le nombre réel d’octets retournés par la fonction dans la mémoire tampon de sortie.

Si lpOverlapped a lavaleur NULL (E/S nonoverlapped), lpBytesReturned est utilisé en interne et ne peut pas être NULL.

Si lpOverlapped n’a pas la valeur NULL (E/S superposées), lpBytesReturned peut avoir la valeur NULL.

lpOverlapped

Pointeur vers une structure CHEVAUCHEMENT .

Si hDevice a été ouvert avec l’indicateur FILE_FLAG_OVERLAPPED, lpOverlapped doit pointer vers une structure OVERLAPPED valide. Dans ce cas, l’opération est effectuée en tant qu’opération superposée (asynchrone). Si l’appareil a été ouvert avec l’indicateur FILE_FLAG_OVERLAPPED et que lpOverlapped a la valeur NULL, la fonction échoue de manière imprévisible.

Si hDevice a été ouvert sans spécifier l’indicateur de FILE_FLAG_OVERLAPPED, lpOverlapped est ignoré et DeviceIoControl ne retourne pas tant que l’opération n’est pas terminée ou jusqu’à ce qu’une erreur se produise.

Valeur retournée

Si l’opération se termine correctement, DeviceIoControl retourne une valeur différente de zéro.

Si l’opération échoue ou est en attente, DeviceIoControl retourne zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Les valeurs spécifiées dans les membres ucACBrightness et ucDCBrightness de la structure DISPLAY_BRIGHTNESS doivent avoir été précédemment retournées par IOCTL_VIDEO_QUERY_SUPPORTED_BRIGHTNESS. Par exemple, si les valeurs prises en charge sont 10, 20, 30, 40, 50, 60, 70, 80, 90 et 100, l’utilisation d’une valeur de 33 serait une erreur.

Le fichier d’en-tête utilisé pour générer des applications qui incluent cette fonctionnalité, Ntddvdeo.h, est inclus dans le Kit de développement du pilote Microsoft Windows (DDK). Pour plus d’informations sur l’obtention du DDK, consultez https://www.microsoft.com/whdc/devtools/ddk/default.mspx.

Vous pouvez également définir ce code de contrôle comme suit :

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

Spécifications

Voir aussi

Interface de contrôle rétro-éclairage

DeviceIoControl

DISPLAY_BRIGHTNESS

IOCTL_VIDEO_QUERY_DISPLAY_BRIGHTNESS

IOCTL_VIDEO_QUERY_SUPPORTED_BRIGHTNESS