WmiSetBrightness method of the WmiMonitorBrightnessMethods class

The WmiSetBrightness method sets the display brightness of a computer monitor.

Syntax

uint32 WmiSetBrightness(
   uint32 Timeout,
   uint8  Brightness
);

Parameters

Timeout

Timeout, in seconds.

Brightness

Brightness, in percent.

Return value

Returns zero (0) to indicate success. Any other number indicates an error. For more information about error codes, see WMI Error Constants or WbemErrorEnum.

Examples

For an extended discussion of retrieving and setting monitor brightness, see the Scripting Guy's Use PowerShell to Report and Set Monitor Brightness blog topic.

The following PowerShell sample sets the brightness of the monitor to 50%.

$brightness = 50
$delay = 5
$myMonitor = Get-WmiObject -Namespace root\wmi -Class WmiMonitorBrightnessMethods
$myMonitor.wmisetbrightness($delay, $brightness)

Requirements

Requirement	Value
Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008
Namespace	Root\wmi
MOF	WmiCore.mof
DLL	WmiProv.dll

See also

WmiMonitorBrightnessMethods

MSMonitorClass