ホーム › System.Performance › PERF_COUNTER_REG_INFO

PERF_COUNTER_REG_INFO

構造体

📘 Microsoft Learn (日本語) · English

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

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

フィールド

型

サイズ

x64

x86

説明

CounterId

DWORD

カウンターセット内でパフォーマンスカウンターを一意に識別する識別子です。1 つのカウンターセットには、最大 64,000 個のパフォーマンスカウンターを含めることができます。

Type

DWORD

パフォーマンスカウンターの種類です。定義済みのカウンターの種類については、Windows Server 2003 Deployment Kit の「Counter Types」セクションを参照してください。コンシューマーは、カウンターの種類を使用してカウンター値の計算方法と表示方法を判断します。プロバイダーは、使用するカウンターの種類を定義済みの一覧の範囲に限定してください。

指定できる値は次のとおりです。

PERF_100NSEC_MULTI_TIMER

PERF_100NSEC_MULTI_TIMER_II

PERF_100NSEC_TIMER

PERF_100NSEC_TIMER_INV

PERF_AVERAGE_BASE

PERF_AVERAGE_BULK

PERF_AVERAGE_TIMER

PERF_COUNTER_100NS_QUEUELEN_TYPE

PERF_COUNTER_BULK_COUNT

PERF_COUNTER_COUNTER

PERF_COUNTER_DELTA

PERF_COUNTER_LARGE_DELTA

PERF_COUNTER_LARGE_QUEUELEN_TYPE

PERF_COUNTER_LARGE_RAWCOUNT

PERF_COUNTER_LARGE_RAWCOUNT_HEX

PERF_COUNTER_MULTI_TIMER

PERF_COUNTER_MULTI_TIMER_INV

PERF_COUNTER_OBJ_QUEUELEN_TYPE

PERF_COUNTER_RAWCOUNT

PERF_COUNTER_RAWCOUNT_HEX

PERF_COUNTER_TEXT

PERF_COUNTER_TIMER

PERF_COUNTER_TIMER_INV

PERF_ELAPSED_TIME

PERF_LARGE_RAW_BASE

PERF_OBJ_TIME_TIMER

PERF_PRECISION_100NS_TIMER

PERF_PRECISION_TIMER

PERF_PRECISION_OBJECT_TIMER

PERF_RAW_BASE

PERF_RAW_FRACTION

PERF_SAMPLE_COUNTER

PERF_SAMPLE_FRACTION

Attrib

ULONGLONG

このカウンターの表示方法を示す 1 つ以上の属性です。

指定できる値は次のとおりです。

値	意味
PERF_ATTRIB_BY_REFERENCE	カウンターの値を、値渡しではなく参照によって取得します。
PERF_ATTRIB_NO_DISPLAYABLE	カウンターの値を表示しません。
PERF_ATTRIB_NO_GROUP_SEPARATOR	カウンターの値を表示するときに桁区切り記号を使用しません。
PERF_ATTRIB_DISPLAY_AS_REAL	カウンターの値を実数値として表示します。
PERF_ATTRIB_DISPLAY_AS_HEX	カウンターの値を 16 進数として表示します。

PERF_ATTRIB_NO_GROUP_SEPARATOR、PERF_ATTRIB_DISPLAY_AS_REAL、PERF_ATTRIB_DISPLAY_AS_HEX の各属性は、相互に排他的ではありません。3 つの属性をすべて指定した場合は、記載されている順序で属性が優先されます。

DetailLevel

DWORD

+16

このカウンターの対象となるユーザー層です。

指定できる値は次のとおりです。

値	意味
PERF_DETAIL_NOVICE	どのレベルのユーザーに対してもカウンターを表示できます。
PERF_DETAIL_ADVANCED	このカウンターは内容が複雑であるため、上級ユーザーにのみ表示してください。

DefaultScale

INT

+20

生のパフォーマンスカウンター値に適用するスケーリング係数です。有効な値は -10 から 10 までの範囲です。スケールを適用しない場合は 0 になります。この値が 0 の場合はスケール値が 1、1 の場合は 10、-1 の場合は .10 のようになります。パフォーマンスカウンターのスケール適用後の値は、パフォーマンスカウンターの生の値に、DefaultScale メンバーが指定する値を指数とする 10 の累乗を掛けた値になります。

BaseCounterId

DWORD

+24

ベースカウンターのカウンター識別子です。0xFFFFFFFF は、ベースカウンターが存在しないことを示します。

PerfTimeId

DWORD

+28

パフォーマンスカウンターのカウンター識別子です。0xFFFFFFFF は、パフォーマンスカウンターが存在しないことを示します。

PerfFreqId

DWORD

+32

周波数カウンターのカウンター識別子です。0xFFFFFFFF は、周波数カウンターが存在しないことを示します。

MultiId

DWORD

+36

マルチカウンターのカウンター識別子です。0xFFFFFFFF は、マルチカウンターが存在しないことを示します。

AggregateFunc

PERF_COUNTER_AGGREGATE_FUNC

+40

カウンターが属するカウンターセットの種類が Global Aggregate、Multiple Instance Aggregate、または Global Aggregate History である場合に、クライアントがそのカウンターに適用する集計関数です。

カウンターセットの種類が Multiple Instance Aggregate の場合、集計の対象となるカウンターインスタンスはクライアントが指定します。それ以外の場合、クライアントはカウンターセットのすべてのインスタンスにわたって値を集計する必要があります。次のいずれかの値を指定しなければなりません。

値	意味
PERF_AGGREGATE_UNDEFINED	未定義です。
PERF_AGGREGATE_TOTAL	返されたカウンターインスタンスの値の合計です。
PERF_AGGREGATE_AVG	返されたカウンターインスタンスの値の平均です。
PERF_AGGREGATE_MIN	返されたカウンターインスタンスの値のうちの最小値です。
PERF_AGGREGATE_MAX	返されたカウンターインスタンスの値のうちの最大値です。

Reserved

DWORD

+44

予約済みです。

公式ドキュメント

パフォーマンスカウンターに関する登録情報を提供します。

解説(Remarks)

PerfQueryCounterSetRegistrationInfo 関数を、requestCode パラメーターに PERF_REG_COUNTERSET_STRUCT を指定して呼び出すと、1 つ以上の PERF_COUNTER_REG_INFO 構造体を含む PERF_COUNTERSET_REG_INFO ブロックが取得されます。

PerfQueryCounterSetRegistrationInfo 関数を、requestCode パラメーターに PERF_REG_COUNTER_STRUCT を指定して呼び出すと、PERF_COUNTER_REG_INFO 構造体が取得されます。

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

各言語での定義

#include <windows.h>

// PERF_COUNTER_REG_INFO  (x64 48 / x86 48 バイト)
typedef struct PERF_COUNTER_REG_INFO {
    DWORD CounterId;
    DWORD Type;
    ULONGLONG Attrib;
    DWORD DetailLevel;
    INT DefaultScale;
    DWORD BaseCounterId;
    DWORD PerfTimeId;
    DWORD PerfFreqId;
    DWORD MultiId;
    PERF_COUNTER_AGGREGATE_FUNC AggregateFunc;
    DWORD Reserved;
} PERF_COUNTER_REG_INFO;

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct PERF_COUNTER_REG_INFO
{
    public uint CounterId;
    public uint Type;
    public ulong Attrib;
    public uint DetailLevel;
    public int DefaultScale;
    public uint BaseCounterId;
    public uint PerfTimeId;
    public uint PerfFreqId;
    public uint MultiId;
    public uint AggregateFunc;
    public uint Reserved;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure PERF_COUNTER_REG_INFO
    Public CounterId As UInteger
    Public Type As UInteger
    Public Attrib As ULong
    Public DetailLevel As UInteger
    Public DefaultScale As Integer
    Public BaseCounterId As UInteger
    Public PerfTimeId As UInteger
    Public PerfFreqId As UInteger
    Public MultiId As UInteger
    Public AggregateFunc As UInteger
    Public Reserved As UInteger
End Structure

import ctypes
from ctypes import wintypes

class PERF_COUNTER_REG_INFO(ctypes.Structure):
    _fields_ = [
        ("CounterId", wintypes.DWORD),
        ("Type", wintypes.DWORD),
        ("Attrib", ctypes.c_ulonglong),
        ("DetailLevel", wintypes.DWORD),
        ("DefaultScale", ctypes.c_int),
        ("BaseCounterId", wintypes.DWORD),
        ("PerfTimeId", wintypes.DWORD),
        ("PerfFreqId", wintypes.DWORD),
        ("MultiId", wintypes.DWORD),
        ("AggregateFunc", wintypes.DWORD),
        ("Reserved", wintypes.DWORD),
    ]

#[repr(C)]
pub struct PERF_COUNTER_REG_INFO {
    pub CounterId: u32,
    pub Type: u32,
    pub Attrib: u64,
    pub DetailLevel: u32,
    pub DefaultScale: i32,
    pub BaseCounterId: u32,
    pub PerfTimeId: u32,
    pub PerfFreqId: u32,
    pub MultiId: u32,
    pub AggregateFunc: u32,
    pub Reserved: u32,
}

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

type PERF_COUNTER_REG_INFO struct {
	CounterId uint32
	Type uint32
	Attrib uint64
	DetailLevel uint32
	DefaultScale int32
	BaseCounterId uint32
	PerfTimeId uint32
	PerfFreqId uint32
	MultiId uint32
	AggregateFunc uint32
	Reserved uint32
}

type
  PERF_COUNTER_REG_INFO = record
    CounterId: DWORD;
    Type: DWORD;
    Attrib: UInt64;
    DetailLevel: DWORD;
    DefaultScale: Integer;
    BaseCounterId: DWORD;
    PerfTimeId: DWORD;
    PerfFreqId: DWORD;
    MultiId: DWORD;
    AggregateFunc: DWORD;
    Reserved: DWORD;
  end;

const PERF_COUNTER_REG_INFO = extern struct {
    CounterId: u32,
    Type: u32,
    Attrib: u64,
    DetailLevel: u32,
    DefaultScale: i32,
    BaseCounterId: u32,
    PerfTimeId: u32,
    PerfFreqId: u32,
    MultiId: u32,
    AggregateFunc: u32,
    Reserved: u32,
};

type
  PERF_COUNTER_REG_INFO {.bycopy.} = object
    CounterId: uint32
    Type: uint32
    Attrib: uint64
    DetailLevel: uint32
    DefaultScale: int32
    BaseCounterId: uint32
    PerfTimeId: uint32
    PerfFreqId: uint32
    MultiId: uint32
    AggregateFunc: uint32
    Reserved: uint32

struct PERF_COUNTER_REG_INFO
{
    uint CounterId;
    uint Type;
    ulong Attrib;
    uint DetailLevel;
    int DefaultScale;
    uint BaseCounterId;
    uint PerfTimeId;
    uint PerfFreqId;
    uint MultiId;
    uint AggregateFunc;
    uint Reserved;
}

HSP用定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; PERF_COUNTER_REG_INFO サイズ: 48 バイト(x64)
dim st, 12    ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; CounterId : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; Type : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; Attrib : ULONGLONG (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; DetailLevel : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; DefaultScale : INT (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; BaseCounterId : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; PerfTimeId : DWORD (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; PerfFreqId : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; MultiId : DWORD (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; AggregateFunc : PERF_COUNTER_AGGREGATE_FUNC (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; Reserved : DWORD (+44, 4byte)  st.11 = 値  /  値 = st.11   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global PERF_COUNTER_REG_INFO
    #field int CounterId
    #field int Type
    #field int64 Attrib
    #field int DetailLevel
    #field int DefaultScale
    #field int BaseCounterId
    #field int PerfTimeId
    #field int PerfFreqId
    #field int MultiId
    #field int AggregateFunc
    #field int Reserved
#endstruct

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

PERF_COUNTER_REG_INFO

フィールド

PERF_100NSEC_MULTI_TIMER

PERF_100NSEC_MULTI_TIMER_II

PERF_100NSEC_TIMER

PERF_100NSEC_TIMER_INV

PERF_AVERAGE_BASE

PERF_AVERAGE_BULK

PERF_AVERAGE_TIMER

PERF_COUNTER_100NS_QUEUELEN_TYPE

PERF_COUNTER_BULK_COUNT

PERF_COUNTER_COUNTER

PERF_COUNTER_DELTA

PERF_COUNTER_LARGE_DELTA

PERF_COUNTER_LARGE_QUEUELEN_TYPE

PERF_COUNTER_LARGE_RAWCOUNT

PERF_COUNTER_LARGE_RAWCOUNT_HEX

PERF_COUNTER_MULTI_TIMER

PERF_COUNTER_MULTI_TIMER_INV

PERF_COUNTER_OBJ_QUEUELEN_TYPE

PERF_COUNTER_RAWCOUNT

PERF_COUNTER_RAWCOUNT_HEX

PERF_COUNTER_TEXT

PERF_COUNTER_TIMER

PERF_COUNTER_TIMER_INV

PERF_ELAPSED_TIME

PERF_LARGE_RAW_BASE

PERF_OBJ_TIME_TIMER

PERF_PRECISION_100NS_TIMER

PERF_PRECISION_TIMER

PERF_PRECISION_OBJECT_TIMER

PERF_RAW_BASE

PERF_RAW_FRACTION

PERF_SAMPLE_COUNTER

PERF_SAMPLE_FRACTION

公式ドキュメント

解説(Remarks)

各言語での定義

HSP用 定義

HSP用定義