Win32 API 日本語リファレンス
ホーム › System.Power › PROCESSOR_POWER_POLICY

PROCESSOR_POWER_POLICY

構造体
📘 Microsoft Learn (日本語) · English
サイズx64: 76 バイト / x86: 76 バイト

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

フィールド

フィールド型サイズx64x86説明
RevisionDWORD4+0+0このプロセッサ電源ポリシー構造体のリビジョン番号。
DynamicThrottleBYTE1+4+4動的スロットリングのポリシーを示す値。
SpareBYTE3+5+5アライメント用の予備バイト配列。
_bitfieldDWORD4+8+8DisableCStates等の制御フラグを格納するビットフィールド。
PolicyCountDWORD4+12+12Policyフィールドに含まれるポリシー要素の数。
PolicyPROCESSOR_POWER_POLICY_INFO60+16+16各パフォーマンス状態のポリシー情報を格納する配列。

各言語での定義

#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