ホーム › System.Power › PROCESSOR_POWER_POLICY

PROCESSOR_POWER_POLICY

構造体

サイズx64: 76 バイト / x86: 76 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールド	型	サイズ	x64	x86	説明
Revision	DWORD	4	+0	+0	現在の構造体のリビジョンレベルです。電源ポリシーを設定するために PROCESSOR_POWER_POLICY 構造体を使用する前に、ReadProcessorPwrScheme を呼び出してこの値を設定します。
DynamicThrottle	BYTE	1	+4	+4	現在のプロセッサーパフォーマンス状態のポリシーです。このメンバーは、 Processor Performance Control Policy Constants に記載されている値のいずれかでなければなりません。
Spare	BYTE	3	+5	+5	予約済みです。0 を設定します。
_bitfield	DWORD	4	+8	+8	DisableCStates等の制御フラグを格納するビットフィールド。
PolicyCount	DWORD	4	+12	+12	Policy 配列の要素数です。
Policy	PROCESSOR_POWER_POLICY_INFO	60	+16	+16	プロセッサーの C-state ポリシー設定を適用するために使用する値を定義する PROCESSOR_POWER_POLICY_INFO 構造体の配列です。Policy[0] は ACPI C-state の C1、Policy[1] は C2、Policy[2] は C3 に対応します。AllowPromotion メンバーは、プロセッサーがその状態へ昇格できるかどうかを決定します。たとえば、Policy[0].AllowPromotion が 0 の場合、コンピューターは C0 から C1 へ遷移できません。

公式ドキュメント

プロセッサーのパフォーマンス制御と C-state に関する情報を格納します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// PROCESSOR_POWER_POLICY_INFO  (x64 20 / x86 20 バイト)
typedef struct PROCESSOR_POWER_POLICY_INFO {
    DWORD TimeCheck;
    DWORD DemoteLimit;
    DWORD PromoteLimit;
    BYTE DemotePercent;
    BYTE PromotePercent;
    BYTE Spare[2];
    DWORD _bitfield;
} PROCESSOR_POWER_POLICY_INFO;

// PROCESSOR_POWER_POLICY  (x64 76 / x86 76 バイト)
typedef struct PROCESSOR_POWER_POLICY {
    DWORD Revision;
    BYTE DynamicThrottle;
    BYTE Spare[3];
    DWORD _bitfield;
    DWORD PolicyCount;
    PROCESSOR_POWER_POLICY_INFO Policy[3];
} PROCESSOR_POWER_POLICY;

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct PROCESSOR_POWER_POLICY_INFO
{
    public uint TimeCheck;
    public uint DemoteLimit;
    public uint PromoteLimit;
    public byte DemotePercent;
    public byte PromotePercent;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 2)] public byte[] Spare;
    public uint _bitfield;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct PROCESSOR_POWER_POLICY
{
    public uint Revision;
    public byte DynamicThrottle;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 3)] public byte[] Spare;
    public uint _bitfield;
    public uint PolicyCount;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 3)] public PROCESSOR_POWER_POLICY_INFO[] Policy;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure PROCESSOR_POWER_POLICY_INFO
    Public TimeCheck As UInteger
    Public DemoteLimit As UInteger
    Public PromoteLimit As UInteger
    Public DemotePercent As Byte
    Public PromotePercent As Byte
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=2)> Public Spare() As Byte
    Public _bitfield As UInteger
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure PROCESSOR_POWER_POLICY
    Public Revision As UInteger
    Public DynamicThrottle As Byte
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=3)> Public Spare() As Byte
    Public _bitfield As UInteger
    Public PolicyCount As UInteger
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=3)> Public Policy() As PROCESSOR_POWER_POLICY_INFO
End Structure

import ctypes
from ctypes import wintypes

class PROCESSOR_POWER_POLICY_INFO(ctypes.Structure):
    _fields_ = [
        ("TimeCheck", wintypes.DWORD),
        ("DemoteLimit", wintypes.DWORD),
        ("PromoteLimit", wintypes.DWORD),
        ("DemotePercent", ctypes.c_ubyte),
        ("PromotePercent", ctypes.c_ubyte),
        ("Spare", ctypes.c_ubyte * 2),
        ("_bitfield", wintypes.DWORD),
    ]

class PROCESSOR_POWER_POLICY(ctypes.Structure):
    _fields_ = [
        ("Revision", wintypes.DWORD),
        ("DynamicThrottle", ctypes.c_ubyte),
        ("Spare", ctypes.c_ubyte * 3),
        ("_bitfield", wintypes.DWORD),
        ("PolicyCount", wintypes.DWORD),
        ("Policy", PROCESSOR_POWER_POLICY_INFO * 3),
    ]

#[repr(C)]
pub struct PROCESSOR_POWER_POLICY_INFO {
    pub TimeCheck: u32,
    pub DemoteLimit: u32,
    pub PromoteLimit: u32,
    pub DemotePercent: u8,
    pub PromotePercent: u8,
    pub Spare: [u8; 2],
    pub _bitfield: u32,
}

#[repr(C)]
pub struct PROCESSOR_POWER_POLICY {
    pub Revision: u32,
    pub DynamicThrottle: u8,
    pub Spare: [u8; 3],
    pub _bitfield: u32,
    pub PolicyCount: u32,
    pub Policy: [PROCESSOR_POWER_POLICY_INFO; 3],
}

import "golang.org/x/sys/windows"

type PROCESSOR_POWER_POLICY_INFO struct {
	TimeCheck uint32
	DemoteLimit uint32
	PromoteLimit uint32
	DemotePercent byte
	PromotePercent byte
	Spare [2]byte
	_bitfield uint32
}

type PROCESSOR_POWER_POLICY struct {
	Revision uint32
	DynamicThrottle byte
	Spare [3]byte
	_bitfield uint32
	PolicyCount uint32
	Policy [3]PROCESSOR_POWER_POLICY_INFO
}

type
  PROCESSOR_POWER_POLICY_INFO = record
    TimeCheck: DWORD;
    DemoteLimit: DWORD;
    PromoteLimit: DWORD;
    DemotePercent: Byte;
    PromotePercent: Byte;
    Spare: array[0..1] of Byte;
    _bitfield: DWORD;
  end;

  PROCESSOR_POWER_POLICY = record
    Revision: DWORD;
    DynamicThrottle: Byte;
    Spare: array[0..2] of Byte;
    _bitfield: DWORD;
    PolicyCount: DWORD;
    Policy: array[0..2] of PROCESSOR_POWER_POLICY_INFO;
  end;

const PROCESSOR_POWER_POLICY_INFO = extern struct {
    TimeCheck: u32,
    DemoteLimit: u32,
    PromoteLimit: u32,
    DemotePercent: u8,
    PromotePercent: u8,
    Spare: [2]u8,
    _bitfield: u32,
};

const PROCESSOR_POWER_POLICY = extern struct {
    Revision: u32,
    DynamicThrottle: u8,
    Spare: [3]u8,
    _bitfield: u32,
    PolicyCount: u32,
    Policy: [3]PROCESSOR_POWER_POLICY_INFO,
};

type
  PROCESSOR_POWER_POLICY_INFO {.bycopy.} = object
    TimeCheck: uint32
    DemoteLimit: uint32
    PromoteLimit: uint32
    DemotePercent: uint8
    PromotePercent: uint8
    Spare: array[2, uint8]
    _bitfield: uint32

  PROCESSOR_POWER_POLICY {.bycopy.} = object
    Revision: uint32
    DynamicThrottle: uint8
    Spare: array[3, uint8]
    _bitfield: uint32
    PolicyCount: uint32
    Policy: array[3, PROCESSOR_POWER_POLICY_INFO]

struct PROCESSOR_POWER_POLICY_INFO
{
    uint TimeCheck;
    uint DemoteLimit;
    uint PromoteLimit;
    ubyte DemotePercent;
    ubyte PromotePercent;
    ubyte[2] Spare;
    uint _bitfield;
}

struct PROCESSOR_POWER_POLICY
{
    uint Revision;
    ubyte DynamicThrottle;
    ubyte[3] Spare;
    uint _bitfield;
    uint PolicyCount;
    PROCESSOR_POWER_POLICY_INFO[3] Policy;
}

HSP用定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; PROCESSOR_POWER_POLICY サイズ: 76 バイト(x64)
dim st, 19    ; 4byte整数×19(構造体サイズ 76 / 4 切り上げ)
; Revision : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; DynamicThrottle : BYTE (+4, 1byte)  poke st,4,値  /  値 = peek(st,4)
; Spare : BYTE (+5, 3byte)  varptr(st)+5 を基点に操作(3byte:入れ子/配列)
; _bitfield : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; PolicyCount : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; Policy : PROCESSOR_POWER_POLICY_INFO (+16, 60byte)  varptr(st)+16 を基点に操作(60byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global PROCESSOR_POWER_POLICY_INFO
    #field int TimeCheck
    #field int DemoteLimit
    #field int PromoteLimit
    #field byte DemotePercent
    #field byte PromotePercent
    #field byte Spare 2
    #field int _bitfield
#endstruct

#defstruct global PROCESSOR_POWER_POLICY
    #field int Revision
    #field byte DynamicThrottle
    #field byte Spare 3
    #field int _bitfield
    #field int PolicyCount
    #field PROCESSOR_POWER_POLICY_INFO Policy 3
#endstruct

stdim st, PROCESSOR_POWER_POLICY        ; NSTRUCT 変数を確保
st->Revision = 100
mes "Revision=" + st->Revision

PROCESSOR_POWER_POLICY

フィールド

公式ドキュメント

各言語での定義

HSP用 定義

HSP用定義