Code de contrôle de luminosité de l' _ _ affichage des requêtes vidéo _ IOCTL _
[Ce code de contrôle peut être utilisé dans les systèmes d’exploitation spécifiés dans la section Configuration requise. la prise en charge de ce code de contrôle a été supprimée dans Windows Server 2008 et Windows Vista. Utilisez la classe WmiMonitorBrightness à la place.]
Récupère les niveaux de rétroéclairage AC et DC actuels et l’état d’alimentation actuel.
Pour effectuer cette opération, appelez la fonction DeviceIoControl avec les paramètres suivants.
BOOL DeviceIoControl(
(HANDLE) hDevice, // handle to device
IOCTL_VIDEO_QUERY_DISPLAY_BRIGHTNESS, // dwIoControlCode
NULL, // lpInBuffer
0, // nInBufferSize
(LPVOID) lpOutBuffer, // output buffer
(DWORD) nOutBufferSize, // size of output buffer
(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 _ des requêtes vidéo IOCTL pour cette opération.
-
lpInBuffer
-
Non utilisé avec cette opération ; Affectez la valeur null.
-
nInBufferSize
-
Non utilisé avec cette opération ; défini à zéro.
-
lpOutBuffer
-
Pointeur vers une mémoire tampon qui reçoit une structure de _ luminosité de l’affichage.
-
nOutBufferSize
-
Taille de la mémoire tampon de sortie en octets.
-
lpBytesReturned
-
Pointeur vers une variable qui reçoit la taille, en octets, des données de sortie retournées.
Si la mémoire tampon de sortie est trop petite pour retourner des données, l’appel échoue, GetLastError retourne l’erreur de code d’erreur _ mémoire tampon insuffisante _ et le nombre d’octets retournés est égal à zéro.
Si la mémoire tampon de sortie est trop petite pour contenir toutes les données mais peut contenir des entrées, le système d’exploitation retourne autant d’éléments que vous le souhaitez, l’appel échoue, GetLastError retourne le code d’erreur _ plus de _ données, et lpBytesReturned indique la quantité de données retournées. Votre application doit à nouveau appeler DeviceIoControl avec la même opération, en spécifiant un nouveau point de départ.
Si lpOverlapped a la valeur null (e/s nonoverlapped), lpBytesReturned 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. S’il s’agit d’une opération avec chevauchement, vous pouvez récupérer le nombre d’octets retournés en appelant la fonction GetOverlappedResult . Si hDevice est associé à un port de terminaison d’e/s, vous pouvez récupérer le nombre d’octets renvoyés en appelant la fonction GetQueuedCompletionStatus .
-
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
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_QUERY_DISPLAY_BRIGHTNESS \
CTL_CODE(FILE_DEVICE_VIDEO, 0x126, METHOD_BUFFERED, FILE_ANY_ACCESS)
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows XP avec les [ applications de bureau SP1 uniquement] |
| Serveur minimal pris en charge |
Windows Serveur 2003 [ applications de bureau uniquement] |
| Fin de la prise en charge des clients |
Windows XP SP2 |
| Fin de la prise en charge des serveurs |
Windows Server 2003 R2 |
| En-tête |
|