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

PDH_COUNTER_INFO_A

構造体
サイズx64: 112 バイト / x86: 72 バイト

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

フィールド

フィールドサイズx64x86説明
dwLengthDWORD4+0+0構造体のサイズ(末尾に追加される文字列を含む)。バイト単位です。
dwTypeDWORD4+4+4カウンターの種類。カウンターの種類の一覧については、Windows Server 2003 Deployment Kit の「Counter Types」セクションを参照してください。カウンターの種類の定数は Winperf.h で定義されています。
CVersionDWORD4+8+8カウンターのバージョン情報。 使用されません。
CStatusDWORD4+12+12カウンターの値が有効かどうかを示すカウンターの状態。指定できる値の一覧については、 Checking PDH Interface Return Values を参照してください。
lScaleINT4+16+16カウンターの表示用の値を計算するときに使用するスケール係数。 スケール係数は 10 のべき乗です。このパラメーターの有効な範囲は PDH_MIN_SCALE (–7)(返される値は実際の値に 10⁷ を掛けた値になります)から PDH_MAX_SCALE (+7)(返される値は実際の値に 10⁺⁷ を掛けた値になります)までです。0 を指定するとスケールは 1 に設定され、実際の値がそのまま返されます
lDefaultScaleINT4+20+20カウンターのプロバイダーが推奨する既定のスケール係数。
dwUserDataUINT_PTR8/4+24+24PdhAddCounter を呼び出したときに dwUserData パラメーターに渡された値。
dwQueryUserDataUINT_PTR8/4+32+28PdhOpenQuery を呼び出したときに dwUserData パラメーターに渡された値。
szFullPathLPSTR8/4+40+32完全なカウンターパスを指定する Null 終端文字列。この文字列はメモリ内でこの構造体の直後に続きます。
Anonymous_Anonymous_e__Union48/28+48+36パスを構成する各要素(マシン/オブジェクト/インスタンス/カウンタ名等)を保持する共用体である。
szExplainTextLPSTR8/4+96+64カウンターを説明するヘルプテキスト。ソースがログファイルの場合は NULL です。
DataBufferDWORD4+104+68構造体に追加される文字列データの先頭。

共用体: _Anonymous_e__Union x64 48B / x86 28B

フィールドサイズx64x86説明
DataItemPathPDH_DATA_ITEM_PATH_ELEMENTS_A40/28+0+0PDH_DATA_ITEM_PATH_ELEMENTS 構造体。使用されません。
CounterPathPDH_COUNTER_PATH_ELEMENTS_A48/24+0+0PDH_COUNTER_PATH_ELEMENTS 構造体。
Anonymous_Anonymous_e__Struct8/4+0+0パスを構成する各要素(マシン/オブジェクト/インスタンス/カウンタ名等)を保持する共用体である。

公式ドキュメント

PDH_COUNTER_INFO 構造体には、カウンターのプロパティを説明する情報が格納されます。この情報にはカウンターのパスも含まれます。

解説(Remarks)

この構造体のメモリを割り当てるときは、szCounterName のように構造体の末尾に追加されるメンバー文字列の分も含めて、十分なメモリを割り当ててください。

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

各言語での定義

#include <windows.h>

// PDH_COUNTER_INFO_A  (x64 112 / x86 72 バイト)
typedef struct PDH_COUNTER_INFO_A {
    DWORD dwLength;
    DWORD dwType;
    DWORD CVersion;
    DWORD CStatus;
    INT lScale;
    INT lDefaultScale;
    UINT_PTR dwUserData;
    UINT_PTR dwQueryUserData;
    LPSTR szFullPath;
    _Anonymous_e__Union Anonymous;
    LPSTR szExplainText;
    DWORD DataBuffer[1];
} PDH_COUNTER_INFO_A;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct PDH_COUNTER_INFO_A
{
    public uint dwLength;
    public uint dwType;
    public uint CVersion;
    public uint CStatus;
    public int lScale;
    public int lDefaultScale;
    public UIntPtr dwUserData;
    public UIntPtr dwQueryUserData;
    public IntPtr szFullPath;
    public _Anonymous_e__Union Anonymous;
    public IntPtr szExplainText;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 1)] public uint[] DataBuffer;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure PDH_COUNTER_INFO_A
    Public dwLength As UInteger
    Public dwType As UInteger
    Public CVersion As UInteger
    Public CStatus As UInteger
    Public lScale As Integer
    Public lDefaultScale As Integer
    Public dwUserData As UIntPtr
    Public dwQueryUserData As UIntPtr
    Public szFullPath As IntPtr
    Public Anonymous As _Anonymous_e__Union
    Public szExplainText As IntPtr
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=1)> Public DataBuffer() As UInteger
End Structure
import ctypes
from ctypes import wintypes

class PDH_COUNTER_INFO_A(ctypes.Structure):
    _fields_ = [
        ("dwLength", wintypes.DWORD),
        ("dwType", wintypes.DWORD),
        ("CVersion", wintypes.DWORD),
        ("CStatus", wintypes.DWORD),
        ("lScale", ctypes.c_int),
        ("lDefaultScale", ctypes.c_int),
        ("dwUserData", ctypes.c_size_t),
        ("dwQueryUserData", ctypes.c_size_t),
        ("szFullPath", ctypes.c_void_p),
        ("Anonymous", _Anonymous_e__Union),
        ("szExplainText", ctypes.c_void_p),
        ("DataBuffer", wintypes.DWORD * 1),
    ]
#[repr(C)]
pub struct PDH_COUNTER_INFO_A {
    pub dwLength: u32,
    pub dwType: u32,
    pub CVersion: u32,
    pub CStatus: u32,
    pub lScale: i32,
    pub lDefaultScale: i32,
    pub dwUserData: usize,
    pub dwQueryUserData: usize,
    pub szFullPath: *mut core::ffi::c_void,
    pub Anonymous: _Anonymous_e__Union,
    pub szExplainText: *mut core::ffi::c_void,
    pub DataBuffer: [u32; 1],
}
import "golang.org/x/sys/windows"

type PDH_COUNTER_INFO_A struct {
	dwLength uint32
	dwType uint32
	CVersion uint32
	CStatus uint32
	lScale int32
	lDefaultScale int32
	dwUserData uintptr
	dwQueryUserData uintptr
	szFullPath uintptr
	Anonymous _Anonymous_e__Union
	szExplainText uintptr
	DataBuffer [1]uint32
}
type
  PDH_COUNTER_INFO_A = record
    dwLength: DWORD;
    dwType: DWORD;
    CVersion: DWORD;
    CStatus: DWORD;
    lScale: Integer;
    lDefaultScale: Integer;
    dwUserData: NativeUInt;
    dwQueryUserData: NativeUInt;
    szFullPath: Pointer;
    Anonymous: _Anonymous_e__Union;
    szExplainText: Pointer;
    DataBuffer: array[0..0] of DWORD;
  end;
const PDH_COUNTER_INFO_A = extern struct {
    dwLength: u32,
    dwType: u32,
    CVersion: u32,
    CStatus: u32,
    lScale: i32,
    lDefaultScale: i32,
    dwUserData: usize,
    dwQueryUserData: usize,
    szFullPath: ?*anyopaque,
    Anonymous: _Anonymous_e__Union,
    szExplainText: ?*anyopaque,
    DataBuffer: [1]u32,
};
type
  PDH_COUNTER_INFO_A {.bycopy.} = object
    dwLength: uint32
    dwType: uint32
    CVersion: uint32
    CStatus: uint32
    lScale: int32
    lDefaultScale: int32
    dwUserData: uint
    dwQueryUserData: uint
    szFullPath: pointer
    Anonymous: _Anonymous_e__Union
    szExplainText: pointer
    DataBuffer: array[1, uint32]
struct PDH_COUNTER_INFO_A
{
    uint dwLength;
    uint dwType;
    uint CVersion;
    uint CStatus;
    int lScale;
    int lDefaultScale;
    size_t dwUserData;
    size_t dwQueryUserData;
    void* szFullPath;
    _Anonymous_e__Union Anonymous;
    void* szExplainText;
    uint[1] DataBuffer;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; PDH_COUNTER_INFO_A サイズ: 72 バイト(x86)
dim st, 18    ; 4byte整数×18(構造体サイズ 72 / 4 切り上げ)
; dwLength : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwType : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; CVersion : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; CStatus : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; lScale : INT (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; lDefaultScale : INT (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; dwUserData : UINT_PTR (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; dwQueryUserData : UINT_PTR (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; szFullPath : LPSTR (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; Anonymous : _Anonymous_e__Union (+36, 28byte)  varptr(st)+36 を基点に操作(28byte:入れ子/配列)
; szExplainText : LPSTR (+64, 4byte)  st.16 = 値  /  値 = st.16   (lpoke/lpeek も可)
; DataBuffer : DWORD (+68, 4byte)  varptr(st)+68 を基点に操作(4byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; PDH_COUNTER_INFO_A サイズ: 112 バイト(x64)
dim st, 28    ; 4byte整数×28(構造体サイズ 112 / 4 切り上げ)
; dwLength : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwType : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; CVersion : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; CStatus : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; lScale : INT (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; lDefaultScale : INT (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; dwUserData : UINT_PTR (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; dwQueryUserData : UINT_PTR (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; szFullPath : LPSTR (+40, 8byte)  qpoke st,40,値 / qpeek(st,40)  ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; Anonymous : _Anonymous_e__Union (+48, 48byte)  varptr(st)+48 を基点に操作(48byte:入れ子/配列)
; szExplainText : LPSTR (+96, 8byte)  qpoke st,96,値 / qpeek(st,96)  ※IronHSPのみ。3.7/3.8は lpoke st,96,下位 : lpoke st,100,上位
; DataBuffer : DWORD (+104, 4byte)  varptr(st)+104 を基点に操作(4byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global PDH_COUNTER_INFO_A
    #field int dwLength
    #field int dwType
    #field int CVersion
    #field int CStatus
    #field int lScale
    #field int lDefaultScale
    #field intptr dwUserData
    #field intptr dwQueryUserData
    #field intptr szFullPath
    #field byte Anonymous 48
    #field intptr szExplainText
    #field int DataBuffer 1
#endstruct

stdim st, PDH_COUNTER_INFO_A        ; NSTRUCT 変数を確保
st->dwLength = 100
mes "dwLength=" + st->dwLength
; ※union フィールドは byte 列で確保(NSTRUCT は union 非対応)。必要に応じ手動でアクセス。