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

PERF_DATA_BLOCK

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

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

フィールド

フィールド型サイズx64x86説明
SignatureWCHAR8+0+0"PERF" を格納する 4 個のワイド文字の配列です。
LittleEndianDWORD4+8+8カウンター値がビッグエンディアン形式かリトルエンディアン形式かを示します。1 の場合、カウンター値はリトルエンディアン形式です。0 の場合、カウンター値はビッグエンディアン形式です。UNIX コンピューターなどの外部のコンピューターからパフォーマンスデータを取得する場合、この値は 0 (ビッグエンディアン形式) になることがあります。
VersionDWORD4+12+12パフォーマンス構造体のバージョンです。
RevisionDWORD4+16+16パフォーマンス構造体のリビジョンです。
TotalByteLengthDWORD4+20+20パフォーマンスデータブロック全体のサイズ (バイト単位)。
HeaderLengthDWORD4+24+24この構造体のサイズ (バイト単位)。ヘッダーの長さを使用して、パフォーマンスデータブロック内の最初の PERF_OBJECT_TYPE 構造体を見つけます。
NumObjectTypesDWORD4+28+28パフォーマンスデータブロック内のパフォーマンスオブジェクトの数です。
DefaultObjectINT4+32+32予約済みです。
SystemTimeSYSTEMTIME16+36+36システムが監視された時刻です。このメンバーは協定世界時 (UTC) 形式です。
PerfTimeLONGLONG8+56+56監視対象のシステムのパフォーマンスカウンター値 (カウント単位)。詳細については、QueryPerformanceCounter を参照してください。
PerfFreqLONGLONG8+64+64監視対象のシステムのパフォーマンスカウンターの周波数 (1 秒あたりのカウント数)。詳細については、QueryPerformanceFrequency を参照してください。
PerfTime100nSecLONGLONG8+72+72監視対象のシステムのパフォーマンスカウンター値 (100 ナノ秒単位)。詳細については、GetSystemTimeAsFileTime を参照してください。
SystemNameLengthDWORD4+80+80SystemNameOffset にあるコンピューター名のサイズ (バイト単位)。
SystemNameOffsetDWORD4+84+84この構造体の先頭から、監視対象のコンピューターの Unicode 名までのオフセットです。

公式ドキュメント

クエリしたパフォーマンスデータブロックを記述します。たとえば、プロバイダーが返したパフォーマンスオブジェクトの数や、パフォーマンス値を計算するときに使用する時間ベースの値などです。

解説(Remarks)

パフォーマンスデータブロックは、コンシューマーが 1 つ以上のパフォーマンスオブジェクトを取得するために RegQueryValueEx を呼び出したときに返されます。この構造体は、返されるブロックの先頭に位置する構造体です。ブロック内の次の構造体は、パフォーマンスオブジェクトを定義する PERF_OBJECT_TYPE 構造体です。パフォーマンスデータブロックのレイアウトの詳細については、Performance Data Format を参照してください。

コンシューマーは、カウンター値を計算するときに PerfTime、PerfFreq、PerfTime100nSec を使用します。ただし、カウンターの種類に PERF_OBJECT_TIMER フラグが含まれている場合は、PERF_OBJECT_TYPE の PerfTime メンバーと PerfFreq メンバーを使用します。

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

各言語での定義

#include <windows.h>

// SYSTEMTIME  (x64 16 / x86 16 バイト)
typedef struct SYSTEMTIME {
    WORD wYear;
    WORD wMonth;
    WORD wDayOfWeek;
    WORD wDay;
    WORD wHour;
    WORD wMinute;
    WORD wSecond;
    WORD wMilliseconds;
} SYSTEMTIME;

// PERF_DATA_BLOCK  (x64 88 / x86 88 バイト)
typedef struct PERF_DATA_BLOCK {
    WCHAR Signature[4];
    DWORD LittleEndian;
    DWORD Version;
    DWORD Revision;
    DWORD TotalByteLength;
    DWORD HeaderLength;
    DWORD NumObjectTypes;
    INT DefaultObject;
    SYSTEMTIME SystemTime;
    LONGLONG PerfTime;
    LONGLONG PerfFreq;
    LONGLONG PerfTime100nSec;
    DWORD SystemNameLength;
    DWORD SystemNameOffset;
} PERF_DATA_BLOCK;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct SYSTEMTIME
{
    public ushort wYear;
    public ushort wMonth;
    public ushort wDayOfWeek;
    public ushort wDay;
    public ushort wHour;
    public ushort wMinute;
    public ushort wSecond;
    public ushort wMilliseconds;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct PERF_DATA_BLOCK
{
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 4)] public string Signature;
    public uint LittleEndian;
    public uint Version;
    public uint Revision;
    public uint TotalByteLength;
    public uint HeaderLength;
    public uint NumObjectTypes;
    public int DefaultObject;
    public SYSTEMTIME SystemTime;
    public long PerfTime;
    public long PerfFreq;
    public long PerfTime100nSec;
    public uint SystemNameLength;
    public uint SystemNameOffset;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure SYSTEMTIME
    Public wYear As UShort
    Public wMonth As UShort
    Public wDayOfWeek As UShort
    Public wDay As UShort
    Public wHour As UShort
    Public wMinute As UShort
    Public wSecond As UShort
    Public wMilliseconds As UShort
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure PERF_DATA_BLOCK
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=4)> Public Signature As String
    Public LittleEndian As UInteger
    Public Version As UInteger
    Public Revision As UInteger
    Public TotalByteLength As UInteger
    Public HeaderLength As UInteger
    Public NumObjectTypes As UInteger
    Public DefaultObject As Integer
    Public SystemTime As SYSTEMTIME
    Public PerfTime As Long
    Public PerfFreq As Long
    Public PerfTime100nSec As Long
    Public SystemNameLength As UInteger
    Public SystemNameOffset As UInteger
End Structure
import ctypes
from ctypes import wintypes

class SYSTEMTIME(ctypes.Structure):
    _fields_ = [
        ("wYear", ctypes.c_ushort),
        ("wMonth", ctypes.c_ushort),
        ("wDayOfWeek", ctypes.c_ushort),
        ("wDay", ctypes.c_ushort),
        ("wHour", ctypes.c_ushort),
        ("wMinute", ctypes.c_ushort),
        ("wSecond", ctypes.c_ushort),
        ("wMilliseconds", ctypes.c_ushort),
    ]

class PERF_DATA_BLOCK(ctypes.Structure):
    _fields_ = [
        ("Signature", ctypes.c_wchar * 4),
        ("LittleEndian", wintypes.DWORD),
        ("Version", wintypes.DWORD),
        ("Revision", wintypes.DWORD),
        ("TotalByteLength", wintypes.DWORD),
        ("HeaderLength", wintypes.DWORD),
        ("NumObjectTypes", wintypes.DWORD),
        ("DefaultObject", ctypes.c_int),
        ("SystemTime", SYSTEMTIME),
        ("PerfTime", ctypes.c_longlong),
        ("PerfFreq", ctypes.c_longlong),
        ("PerfTime100nSec", ctypes.c_longlong),
        ("SystemNameLength", wintypes.DWORD),
        ("SystemNameOffset", wintypes.DWORD),
    ]
#[repr(C)]
pub struct SYSTEMTIME {
    pub wYear: u16,
    pub wMonth: u16,
    pub wDayOfWeek: u16,
    pub wDay: u16,
    pub wHour: u16,
    pub wMinute: u16,
    pub wSecond: u16,
    pub wMilliseconds: u16,
}

#[repr(C)]
pub struct PERF_DATA_BLOCK {
    pub Signature: [u16; 4],
    pub LittleEndian: u32,
    pub Version: u32,
    pub Revision: u32,
    pub TotalByteLength: u32,
    pub HeaderLength: u32,
    pub NumObjectTypes: u32,
    pub DefaultObject: i32,
    pub SystemTime: SYSTEMTIME,
    pub PerfTime: i64,
    pub PerfFreq: i64,
    pub PerfTime100nSec: i64,
    pub SystemNameLength: u32,
    pub SystemNameOffset: u32,
}
import "golang.org/x/sys/windows"

type SYSTEMTIME struct {
	wYear uint16
	wMonth uint16
	wDayOfWeek uint16
	wDay uint16
	wHour uint16
	wMinute uint16
	wSecond uint16
	wMilliseconds uint16
}

type PERF_DATA_BLOCK struct {
	Signature [4]uint16
	LittleEndian uint32
	Version uint32
	Revision uint32
	TotalByteLength uint32
	HeaderLength uint32
	NumObjectTypes uint32
	DefaultObject int32
	SystemTime SYSTEMTIME
	PerfTime int64
	PerfFreq int64
	PerfTime100nSec int64
	SystemNameLength uint32
	SystemNameOffset uint32
}
type
  SYSTEMTIME = record
    wYear: Word;
    wMonth: Word;
    wDayOfWeek: Word;
    wDay: Word;
    wHour: Word;
    wMinute: Word;
    wSecond: Word;
    wMilliseconds: Word;
  end;

  PERF_DATA_BLOCK = record
    Signature: array[0..3] of WideChar;
    LittleEndian: DWORD;
    Version: DWORD;
    Revision: DWORD;
    TotalByteLength: DWORD;
    HeaderLength: DWORD;
    NumObjectTypes: DWORD;
    DefaultObject: Integer;
    SystemTime: SYSTEMTIME;
    PerfTime: Int64;
    PerfFreq: Int64;
    PerfTime100nSec: Int64;
    SystemNameLength: DWORD;
    SystemNameOffset: DWORD;
  end;
const SYSTEMTIME = extern struct {
    wYear: u16,
    wMonth: u16,
    wDayOfWeek: u16,
    wDay: u16,
    wHour: u16,
    wMinute: u16,
    wSecond: u16,
    wMilliseconds: u16,
};

const PERF_DATA_BLOCK = extern struct {
    Signature: [4]u16,
    LittleEndian: u32,
    Version: u32,
    Revision: u32,
    TotalByteLength: u32,
    HeaderLength: u32,
    NumObjectTypes: u32,
    DefaultObject: i32,
    SystemTime: SYSTEMTIME,
    PerfTime: i64,
    PerfFreq: i64,
    PerfTime100nSec: i64,
    SystemNameLength: u32,
    SystemNameOffset: u32,
};
type
  SYSTEMTIME {.bycopy.} = object
    wYear: uint16
    wMonth: uint16
    wDayOfWeek: uint16
    wDay: uint16
    wHour: uint16
    wMinute: uint16
    wSecond: uint16
    wMilliseconds: uint16

  PERF_DATA_BLOCK {.bycopy.} = object
    Signature: array[4, uint16]
    LittleEndian: uint32
    Version: uint32
    Revision: uint32
    TotalByteLength: uint32
    HeaderLength: uint32
    NumObjectTypes: uint32
    DefaultObject: int32
    SystemTime: SYSTEMTIME
    PerfTime: int64
    PerfFreq: int64
    PerfTime100nSec: int64
    SystemNameLength: uint32
    SystemNameOffset: uint32
struct SYSTEMTIME
{
    ushort wYear;
    ushort wMonth;
    ushort wDayOfWeek;
    ushort wDay;
    ushort wHour;
    ushort wMinute;
    ushort wSecond;
    ushort wMilliseconds;
}

struct PERF_DATA_BLOCK
{
    wchar[4] Signature;
    uint LittleEndian;
    uint Version;
    uint Revision;
    uint TotalByteLength;
    uint HeaderLength;
    uint NumObjectTypes;
    int DefaultObject;
    SYSTEMTIME SystemTime;
    long PerfTime;
    long PerfFreq;
    long PerfTime100nSec;
    uint SystemNameLength;
    uint SystemNameOffset;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; PERF_DATA_BLOCK サイズ: 88 バイト(x64)
dim st, 22    ; 4byte整数×22(構造体サイズ 88 / 4 切り上げ)
; Signature : WCHAR (+0, 8byte)  varptr(st)+0 を基点に操作(8byte:入れ子/配列)
; LittleEndian : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; Version : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; Revision : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; TotalByteLength : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; HeaderLength : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; NumObjectTypes : DWORD (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; DefaultObject : INT (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; SystemTime : SYSTEMTIME (+36, 16byte)  varptr(st)+36 を基点に操作(16byte:入れ子/配列)
; PerfTime : LONGLONG (+56, 8byte)  qpoke st,56,値 / qpeek(st,56)  ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; PerfFreq : LONGLONG (+64, 8byte)  qpoke st,64,値 / qpeek(st,64)  ※IronHSPのみ。3.7/3.8は lpoke st,64,下位 : lpoke st,68,上位
; PerfTime100nSec : LONGLONG (+72, 8byte)  qpoke st,72,値 / qpeek(st,72)  ※IronHSPのみ。3.7/3.8は lpoke st,72,下位 : lpoke st,76,上位
; SystemNameLength : DWORD (+80, 4byte)  st.20 = 値  /  値 = st.20   (lpoke/lpeek も可)
; SystemNameOffset : DWORD (+84, 4byte)  st.21 = 値  /  値 = st.21   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global SYSTEMTIME
    #field short wYear
    #field short wMonth
    #field short wDayOfWeek
    #field short wDay
    #field short wHour
    #field short wMinute
    #field short wSecond
    #field short wMilliseconds
#endstruct

#defstruct global PERF_DATA_BLOCK
    #field wchar Signature 4
    #field int LittleEndian
    #field int Version
    #field int Revision
    #field int TotalByteLength
    #field int HeaderLength
    #field int NumObjectTypes
    #field int DefaultObject
    #field SYSTEMTIME SystemTime
    #field int64 PerfTime
    #field int64 PerfFreq
    #field int64 PerfTime100nSec
    #field int SystemNameLength
    #field int SystemNameOffset
#endstruct

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