_Code de _ contrôle de luminosité d' _ affichage du jeu vidéo IOCTL _

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

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 \ \ . \ Appareil LCD. Pour récupérer un handle d’appareil, appelez la fonction CreateFile .

dwIoControlCode

Code de contrôle de l’opération. Cette valeur identifie l’opération spécifique à effectuer et le type d’appareil sur lequel l’exécuter. Utilisez la luminosité de l' _ affichage du jeu de vidéos _ _ _ IOCTL pour cette opération.

lpInBuffer

Pointeur vers une structure de _ luminosité d’affichage .

nInBufferSize

Taille de la mémoire tampon vers laquelle pointe lpOutBuffer, en octets.

lpOutBuffer

Non utilisé avec cette opération ; Affectez la valeur null.

nOutBufferSize

Non utilisé avec cette opération ; défini à 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 la valeur null (e/s nonoverlapped), lpBytesReturned est utilisé en interne et ne peut pas avoir la valeur null.

Si lpOverlapped n’a pas la valeur null (e/s avec chevauchement), LpBytesReturned peut avoir la valeur null.

lpOverlapped

Pointeur vers une structure OVERLAPPED .

Si hDevice a été ouvert avec l’indicateur de fichier avec _ indicateur de _ chevauchement, lpOverlapped doit pointer vers une structure OVERLAPPED valide. Dans ce cas, l’opération est exécutée en tant qu’opération Overlapped (asynchrone). Si l’appareil a été ouvert avec l’indicateur de fichier avec _ indicateur _ de chevauchement et que LpOverlapped a la valeur null, la fonction échoue de façon imprévisible.

Si hDevice a été ouvert sans que l’indicateur de fichier n’ait été spécifié _ _ , 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 de retour

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 la valeur 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 de _ luminosité d’affichage doivent avoir été retournées par la luminosité de la _ requête vidéo IOCTL _ _ prise en charge _. 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 créer des applications qui incluent cette fonctionnalité, Ntddvdeo. h, est inclus dans Microsoft Windows Driver Development Kit (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

Condition requise Valeur
Client minimal pris en charge
Windows Vista, Windows XP avec les [ applications de bureau SP1 uniquement]
Serveur minimal pris en charge
Windows Serveur 2003 [ applications de bureau uniquement]
En-tête
Ntddvdeo. h

Voir aussi

Interface de contrôle de rétroéclairage

DeviceIoControl

luminosité de l’affichage _

luminosité de l' _ _ affichage des requêtes vidéo _ IOCTL _

_ _ _ luminosité prise en charge des requêtes de vidéo IOCTL _