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

PPM_WMI_IDLE_STATES_EX

構造体
サイズx64: 56 バイト / x86: 52 バイト

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

フィールド

フィールドサイズx64x86説明
TypeDWORD4+0+0アイドル状態セットの種別を示す値。
CountDWORD4+4+4Stateフィールドに含まれるアイドル状態の数。
TargetStateDWORD4+8+8移行先となる目標アイドル状態のインデックス。
OldStateDWORD4+12+12移行前のアイドル状態のインデックス。
TargetProcessorsvoid*8/4+16+16この設定が適用される対象プロセッサを示すポインタ。
StatePPM_WMI_IDLE_STATE32+24+20各アイドル状態の詳細情報を格納する可変長配列。

各言語での定義

#include <windows.h>

// PPM_WMI_IDLE_STATE  (x64 32 / x86 32 バイト)
typedef struct PPM_WMI_IDLE_STATE {
    DWORD Latency;
    DWORD Power;
    DWORD TimeCheck;
    BYTE PromotePercent;
    BYTE DemotePercent;
    BYTE StateType;
    BYTE Reserved;
    DWORD StateFlags;
    DWORD Context;
    DWORD IdleHandler;
    DWORD Reserved1;
} PPM_WMI_IDLE_STATE;

// PPM_WMI_IDLE_STATES_EX  (x64 56 / x86 52 バイト)
typedef struct PPM_WMI_IDLE_STATES_EX {
    DWORD Type;
    DWORD Count;
    DWORD TargetState;
    DWORD OldState;
    void* TargetProcessors;
    PPM_WMI_IDLE_STATE State[1];
} PPM_WMI_IDLE_STATES_EX;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct PPM_WMI_IDLE_STATE
{
    public uint Latency;
    public uint Power;
    public uint TimeCheck;
    public byte PromotePercent;
    public byte DemotePercent;
    public byte StateType;
    public byte Reserved;
    public uint StateFlags;
    public uint Context;
    public uint IdleHandler;
    public uint Reserved1;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct PPM_WMI_IDLE_STATES_EX
{
    public uint Type;
    public uint Count;
    public uint TargetState;
    public uint OldState;
    public IntPtr TargetProcessors;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 1)] public PPM_WMI_IDLE_STATE[] State;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure PPM_WMI_IDLE_STATE
    Public Latency As UInteger
    Public Power As UInteger
    Public TimeCheck As UInteger
    Public PromotePercent As Byte
    Public DemotePercent As Byte
    Public StateType As Byte
    Public Reserved As Byte
    Public StateFlags As UInteger
    Public Context As UInteger
    Public IdleHandler As UInteger
    Public Reserved1 As UInteger
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure PPM_WMI_IDLE_STATES_EX
    Public Type As UInteger
    Public Count As UInteger
    Public TargetState As UInteger
    Public OldState As UInteger
    Public TargetProcessors As IntPtr
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=1)> Public State() As PPM_WMI_IDLE_STATE
End Structure
import ctypes
from ctypes import wintypes

class PPM_WMI_IDLE_STATE(ctypes.Structure):
    _fields_ = [
        ("Latency", wintypes.DWORD),
        ("Power", wintypes.DWORD),
        ("TimeCheck", wintypes.DWORD),
        ("PromotePercent", ctypes.c_ubyte),
        ("DemotePercent", ctypes.c_ubyte),
        ("StateType", ctypes.c_ubyte),
        ("Reserved", ctypes.c_ubyte),
        ("StateFlags", wintypes.DWORD),
        ("Context", wintypes.DWORD),
        ("IdleHandler", wintypes.DWORD),
        ("Reserved1", wintypes.DWORD),
    ]

class PPM_WMI_IDLE_STATES_EX(ctypes.Structure):
    _fields_ = [
        ("Type", wintypes.DWORD),
        ("Count", wintypes.DWORD),
        ("TargetState", wintypes.DWORD),
        ("OldState", wintypes.DWORD),
        ("TargetProcessors", ctypes.c_void_p),
        ("State", PPM_WMI_IDLE_STATE * 1),
    ]
#[repr(C)]
pub struct PPM_WMI_IDLE_STATE {
    pub Latency: u32,
    pub Power: u32,
    pub TimeCheck: u32,
    pub PromotePercent: u8,
    pub DemotePercent: u8,
    pub StateType: u8,
    pub Reserved: u8,
    pub StateFlags: u32,
    pub Context: u32,
    pub IdleHandler: u32,
    pub Reserved1: u32,
}

#[repr(C)]
pub struct PPM_WMI_IDLE_STATES_EX {
    pub Type: u32,
    pub Count: u32,
    pub TargetState: u32,
    pub OldState: u32,
    pub TargetProcessors: *mut core::ffi::c_void,
    pub State: [PPM_WMI_IDLE_STATE; 1],
}
import "golang.org/x/sys/windows"

type PPM_WMI_IDLE_STATE struct {
	Latency uint32
	Power uint32
	TimeCheck uint32
	PromotePercent byte
	DemotePercent byte
	StateType byte
	Reserved byte
	StateFlags uint32
	Context uint32
	IdleHandler uint32
	Reserved1 uint32
}

type PPM_WMI_IDLE_STATES_EX struct {
	Type uint32
	Count uint32
	TargetState uint32
	OldState uint32
	TargetProcessors uintptr
	State [1]PPM_WMI_IDLE_STATE
}
type
  PPM_WMI_IDLE_STATE = record
    Latency: DWORD;
    Power: DWORD;
    TimeCheck: DWORD;
    PromotePercent: Byte;
    DemotePercent: Byte;
    StateType: Byte;
    Reserved: Byte;
    StateFlags: DWORD;
    Context: DWORD;
    IdleHandler: DWORD;
    Reserved1: DWORD;
  end;

  PPM_WMI_IDLE_STATES_EX = record
    Type: DWORD;
    Count: DWORD;
    TargetState: DWORD;
    OldState: DWORD;
    TargetProcessors: Pointer;
    State: array[0..0] of PPM_WMI_IDLE_STATE;
  end;
const PPM_WMI_IDLE_STATE = extern struct {
    Latency: u32,
    Power: u32,
    TimeCheck: u32,
    PromotePercent: u8,
    DemotePercent: u8,
    StateType: u8,
    Reserved: u8,
    StateFlags: u32,
    Context: u32,
    IdleHandler: u32,
    Reserved1: u32,
};

const PPM_WMI_IDLE_STATES_EX = extern struct {
    Type: u32,
    Count: u32,
    TargetState: u32,
    OldState: u32,
    TargetProcessors: ?*anyopaque,
    State: [1]PPM_WMI_IDLE_STATE,
};
type
  PPM_WMI_IDLE_STATE {.bycopy.} = object
    Latency: uint32
    Power: uint32
    TimeCheck: uint32
    PromotePercent: uint8
    DemotePercent: uint8
    StateType: uint8
    Reserved: uint8
    StateFlags: uint32
    Context: uint32
    IdleHandler: uint32
    Reserved1: uint32

  PPM_WMI_IDLE_STATES_EX {.bycopy.} = object
    Type: uint32
    Count: uint32
    TargetState: uint32
    OldState: uint32
    TargetProcessors: pointer
    State: array[1, PPM_WMI_IDLE_STATE]
struct PPM_WMI_IDLE_STATE
{
    uint Latency;
    uint Power;
    uint TimeCheck;
    ubyte PromotePercent;
    ubyte DemotePercent;
    ubyte StateType;
    ubyte Reserved;
    uint StateFlags;
    uint Context;
    uint IdleHandler;
    uint Reserved1;
}

struct PPM_WMI_IDLE_STATES_EX
{
    uint Type;
    uint Count;
    uint TargetState;
    uint OldState;
    void* TargetProcessors;
    PPM_WMI_IDLE_STATE[1] State;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; PPM_WMI_IDLE_STATES_EX サイズ: 52 バイト(x86)
dim st, 13    ; 4byte整数×13(構造体サイズ 52 / 4 切り上げ)
; Type : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; Count : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; TargetState : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; OldState : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; TargetProcessors : void* (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; State : PPM_WMI_IDLE_STATE (+20, 32byte)  varptr(st)+20 を基点に操作(32byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; PPM_WMI_IDLE_STATES_EX サイズ: 56 バイト(x64)
dim st, 14    ; 4byte整数×14(構造体サイズ 56 / 4 切り上げ)
; Type : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; Count : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; TargetState : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; OldState : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; TargetProcessors : void* (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; State : PPM_WMI_IDLE_STATE (+24, 32byte)  varptr(st)+24 を基点に操作(32byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global PPM_WMI_IDLE_STATE
    #field int Latency
    #field int Power
    #field int TimeCheck
    #field byte PromotePercent
    #field byte DemotePercent
    #field byte StateType
    #field byte Reserved
    #field int StateFlags
    #field int Context
    #field int IdleHandler
    #field int Reserved1
#endstruct

#defstruct global PPM_WMI_IDLE_STATES_EX
    #field int Type
    #field int Count
    #field int TargetState
    #field int OldState
    #field intptr TargetProcessors
    #field PPM_WMI_IDLE_STATE State 1
#endstruct

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