Skip to main content
PowerDeterminePlatformRole function

Determines the computer role. To specify a platform, use the PowerDeterminePlatformRoleEx function.

Syntax


POWER_PLATFORM_ROLE WINAPI PowerDeterminePlatformRole(void);

Parameters

This function has no parameters.

Return value

The return value is one of the values from the POWER_PLATFORM_ROLE enumeration.

Remarks

This function reads the ACPI Fixed ACPI Description Table (FADT) to determine the OEM preferred computer role. If that information is not available, the function looks for a battery. If at least one battery is available, the function returns PlatformRoleMobile. If no batteries are available, the function returns PlatformRoleDesktop.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

PowrProf.h

Library

PowrProf.lib

DLL

PowrProf.dll

See also

Power Management Functions
POWER_PLATFORM_ROLE
PowerDeterminePlatformRoleEx