PowerDeterminePlatformRoleEx 関数 (powerbase.h)
指定したプラットフォームのコンピューターの役割を決定します。
構文
POWER_PLATFORM_ROLE PowerDeterminePlatformRoleEx(
[in] ULONG Version
);
パラメーター
[in] Version
プラットフォームの POWER_PLATFORM_ROLE 列挙のバージョン。 このパラメーターには、次の値のいずれかを指定できます。
| 値 | 意味 |
|---|---|
|
現在のビルド ターゲットの POWER_PLATFORM_ROLE 列挙のバージョン。 |
|
Windows 7、Windows Server 2008 R2、Windows Vista、または Windows Server 2008 の POWER_PLATFORM_ROLE 列挙のバージョン。
この値で PowerDeterminePlatformRoleEx を 呼び出すと、Windows 7、Windows Server 2008 R2、Windows Vista、または Windows Server 2008 で PowerDeterminePlatformRole を呼び出した場合と同じ結果が返されます。 |
|
Windows 8とWindows Server 2012のPOWER_PLATFORM_ROLE列挙のバージョン。 |
戻り値
戻り値は、指定したバージョンの POWER_PLATFORM_ROLE 列挙の値のいずれかです。
注釈
この関数は、ACPI 固定 ACPI 説明テーブル (FADT) を読み取り、OEM 優先コンピューターの役割を決定します。 その情報が利用できない場合、関数はバッテリーを探します。 少なくとも 1 つのバッテリーが使用可能な場合、この関数は PlatformRoleMobile を返します。 使用可能なバッテリーがない場合、この関数は PlatformRoleDesktop を返します。
OEM 優先コンピューターの役割が呼び出し元によって指定されたプラットフォームでサポートされていない場合、関数はサポートされている最も近い値を返します。 たとえば、タブレット デバイスで Version of POWER_PLATFORM_ROLE_V1 を使用して PowerDeterminePlatformRoleEx 関数を呼び出すと、PlatformRoleMobile が返されます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | powerbase.h |
| Library | Powrprof.lib |
| [DLL] | Powrprof.dll |