This function is supported by all computers with a backlit LCD screen. See the computer user manual for more information on its backlight capability.
Sets the LCD light inactivity timeout. This timeout is the number of seconds that the computer must sit idle (that is, without key presses or screen touches) before the LCD light will automatically shut off. As a power saving feature, when the duration of inactivity reaches the timeout period midpoint, the LCD light will automatically step to a lower brightness level for the remainder of the timeout period unless an intervening user action occurs to restore the original brightness level.
HRESULT ITCSetScreenLightTimeout(
DWORD dwPowerSelect,
DWORD dwTimeout
)
dwPowerSelect
[in] 0xAC: AC power supply.
[in] 0xDC: Battery or DC power supply.
dwTimeout
[in] LCD light inactivity timeout in seconds. Check the settings on the computer for valid values.
This method limits the timeout to a maximum of 10 minutes when the computer is running on the battery/DC power source. No upper time limit is imposed when the computer is running on external AC power. A value of zero represents infinity when the computer is AC powered (this effectively disables the LCD light's auto-off function).
HRESULT indicating success or failure. Honeywell recommends using the result-code macros to evaluate the return code.
If your computer does not have a backlit screen, this function returns ITC_ERROR_FUNCTION_NOT_SUPPORTED.
Header File: ITC50.H
Library: ITC50.LIB