_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 |
|